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System Generation provides the facilities for the creation and 
maintenance of a monitored system of ibm and user-supplied pro- 
grams. The end product of System Generation is a System 
Operating File, including a System Monitor, that is tailored to 
provide an efficient Operating System for a specific machine 
environment. 

This publication provides systems programmers and systems 
analysts with detailed information on the System Generation 
function. The publication describes the System Generation func- 
tion, the programs used, and — primarily by means of examples 
— the procedures required for both tape-oriented and disk- 
oriented systems. Also included are machine requirements, core- 
storage requirements, and timing information for the elements of 
the ibm 1410/7010 Operating System. The use of customer op- 
tions such as the History file and System Maintenance programs 
is also explained. 

Note: The ibm 1302 Disk Storage Unit is now designated the 
ibm 2302 Disk Storage Unit; there has been no change in the 
unit itself, in the applications for which the unit may be used, 
or in the programming parameters used to specify those appli- 
cations. The ibm 2302 Disk Storage Unit designation has been 
used in the text of this publication; programming parameters 
remain unchanged and refer to 1302. 










Major Revision (October 1965) 

This publication is a major revision of, and obsoletes, the pub- 
lication IBM 1410/7010 Operating System; System Generation, 
Form C28-0352-4. The revision includes expanded discussions 
of Tele-processing System Requirements, Control Cards, Moni- 
tor Definitions, Symbolic Unit Definitions, and iocs Definitions. 
Changes to the text are indicated by a vertical line at the left 
of the affected text. 
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Introduction 



Purpose of this Publication 

This publication provides systems programmers and 
systems analysts with detailed information on the 
System Generation function provided for the 1410/ 
7010 Operating System. The use of a History file (a 
customer option) is discussed, and maintenance of the 
file by use of the SG3 program is explained. 



Purpose of System Generation 

System Generation provides facilities for the genera- 
tion and maintenance of the ibm 1410/7010 Operating 
System, adapted to both the computer and the data 
processing requirements of an installation. 

System Generation is a function performed within 
and for the Operating System, using various Operat- 
ing System programs, under Monitor control. 



Prerequisite and Related Literature 

Prerequisite Literature 

For an understanding of the basic concepts of the 
Operating System, the reader is directed to: 
IBM 1410/7010 Operating System; Basic Concepts, 

Form C28-0318. 
Fqr details on features, functions, and capabilities 
of the Operating System, the reader is directed to: 
IBM 1410/7010 Operating System; System Monitor, 
Form C28-0319. 



Related Literature 

The following ibm 1410/7010 Operating System pub- 
lications are not prerequisite in their entirety to the 
System Generation function, but are recommended 
reading for a general knowledge of the appropriate 
program or programming system to be generated and 
maintained. 
Basic Input/Output Control System, Form C28-0322 
Random-Processing Scheduler, Form C28-0323 
Tele-processing Supervisor, Form C28-0321 
Utility Programs, Form C28-0353 
Generalized Tape Sorting Program, Form C28-0354 
Autocoder, Form C28-0326 



COBOL, Form C28-0327 

FORTRAN, Form C28-0328 

File Organization System for IBM 1301/2302 Disk 
Storage, Form C28-0405 

Generalized Sorting Program Using IBM 1301/2302 
Disk Storage, Form C28-0404 

Support of IBM 1311 Disk Storage Drives, Form 
C28-0402 

Operating instructions for the Operating System, 
including instructions for System Generation, are con- 
tained in: 

Operator's Guide, Form C28-0351. 

A knowledge of material contained in some of the 
above publications is required for System Generation. 
Specific reference to the pertinent information is made 
in this publication. 

Minimum Machine Requirements 

Two versions of the ibm Master file are provided: one 
for a tape-oriented installation, the other for a disk- 
oriented installation. Each is designed to enable the 
user to perform his initial System Generation (the 
creation of a System Generator file). The following 
machine requirements are the minimum configuration 
needed for System Generation. The Master file runs 
on the minimum machine configuration, as well as any 
configuration that exceeds the minimum. (Processing 
Overlap and Priority special features, which are stand- 
ard with the ibm 7010, are required. ) 

For the Tape-Oriented System 

40,000 positions of core storage 
5 magnetic tape units 
1 card reader (or an additional tape unit) 
Note 1: A printer or an additional tape unit for 
the Standard Print Unit is recommended in addition 
to the above machine requirements. 

Note 2: If 1311 Disk Storage is used for data files, 
60,000 positions of core storage are required. 

For the Disk-Oriented System 

60,000 positions of core storage 

1 module of ibm 1301 or 2302 Disk Storage 

2 magnetic tape units 

1 card reader ( or one of the above tape units ) 



Introduction 5 



Note: It is recommended that a printer or addi- 
tional tape unit for the Standard Print Unit be sup- 
plied in addition to the above machine requirements. 



General Concepts 

As distributed to the user, the Master file contains all 
the components of the 1410/7010 Operating System. 
From the Master file, the user generates a System 
Generator file (sgf). From the sgf, the user creates 
one or more System Operating Files (sof) designed 
to perform specific data processing functions. 

Definitions 

Frequently used basic terms are defined below in rela- 
tion to their use in this publication. 

Monitor: The System Monitor without the Linkage 
Loader; that is, the combination of Bootstrap, Resi- 
dent Monitor ( including the Resident iocs ) , and 
Transitional Monitor. 

Operating Section: All operating programs in ab- 
solute format (ready to execute). Monitor is part of 
the operating section. 

Library: An organized collection of subprograms 
or data to be used as input for System Generation. 
There are three types of libraries: 

1. Relocatable Library: Compiled subprograms in 
relocatable format. 

2. Macro Library: All the macro routines available 
to the Autocoder processor. 

3. Create Library: Prewritten packets of Linkage 
Loader control cards used to conveniently process 
standard programs into absolute format. 

Directory: A record, built during System Genera- 
tion, that contains the names and relative locations of 
the items of an associated file. 

Header: An identifying record at the beginning of 
every program phase or library. 

Largest Possible Records: An option offered for 
tape-oriented System Generation (specifically, the 
SG2 program). If this option is exercised, a phase of 
a program will be written in records of as many char- 
acters as possible. The last record of the phase may be 
short to contain any remaining characters. 

Macro Generation: An Autocoder function whereby 
symbolic statements are extracted from the Macro 
Library and become a portion of the subprogram 
being assembled. 

Disk: Refers to ibm 1301 or 2302 Disk Storage. 

Geometric Record Address: A disk record address 
whose four high-order digits are identical to the track 
number on which the record resides. 



Simultaneous Peripheral Operations On Line 
(SPOOL): This programming feature allows card-to- 
tape, tape-to-card, and tape-to-print operations to be 
performed concurrently with batched program (see 
System Monitor). 

Master File: An IBM-supplied source file consisting 
of: 

1. A minimum Monitor capable of operating on any 
acceptable machine configuration; 

2. A basic operating section capable of System Gen- 
eration; and, 

3. The Relocatable, Macro, and Create Libraries. 
System Generator File (SGF): A system file consist- 
ing of: 

1. A Monitor designed to operate efficiently in a par- 
ticular installation environment; 

2. An operating section capable of System Genera- 
tion; and, 

3. The library subprograms required for System 
Generation. 

System Operating File (SOF): A system file consist- 
ing of: 

1. A Monitor designed to operate efficiently in a 
particular installation environment; 

2. An operating section designed to efficiently proc- 
ess the user's programs and data; and, 

3. The library subprograms required for user proc- 
essing. 

The primary difference between the ibm Master file 
and an sgf is the Monitor. On the Master file, the 
Monitor is designed to operate in the minimum ma- 
chine environment. To gain full advantage of the 
Operating System, the user constructs his Monitor to 
utilize the facilities of his installation, and also selects 
any iocs or system function options (e.g., tape-label 
checking and unusual-end-of -program memory print) 
that would be useful to him. After an sgf is created, 
the Master file need not be used again, since the sgf 
effectively becomes the installation's "Master file." 

The distinction between an sgf and an sof is based 
entirely on operating efficiency. The primary differ- 
ence between them is that the sgf must contain those 
elements required for System Generation, but an sof 
need not contain them. An sgf is designed for System 
Generation; an sof for production work. 



Tape- and Disk-Oriented Systems 

Orientation toward tape or disk is determined by the 
device (tape or disk) from which the Resident Moni- 
tor is loaded into core storage. Both systems are dis- 
tributed by ibm as single reels of tape — the Master 



file. The Master file for disk must be loaded onto disk 
storage before it can be used for System Generation. 
A tape-oriented Master file cannot be used for genera- 
tion of a disk-oriented system; similarly, a disk-oriented 
Master file cannot be used for generation of a tape- 
oriented system. 

Tape System 

The operating programs on the Master file for tape 
are designed for tape usage. The user can, after the 
initial System Generation, design his system to use 



disk storage files within the tape system (e.g., a disk 
file can be used for data files). 

Disk System 

The operating programs on the Master file for disk 
are designed for disk usage. Two tape units are man- 
datory for System Generation. The Disk Load program 
is supplied in order to copy the system onto disk. The 
user can, after initial System Generation, design his 
programs to use tape files within the disk system 
( e.g., a tape file can be used for data files ) . 
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Operating System Machine Requirements 



The Processing Overlap and Priority special features 
are required to use the 1410/7010 Operating System. 

System Generation 

The machine requirements for generation of the sgf 
from the Master file are described in the Introduction 
to this publication. 

Data Processing 
Unit-Record Requirements 

All configurations of the Operating System require: 

1 ibm 1402 Card Read Punch, Model 2, for use as 
the Standard Input Unit (sru) and/or the Stand- 
ard Punch Unit (spu); or 1 ibm 1442 Card Reader, 
Model 3, for the siu 

1 ibm 1403 Printer, Model 2, for use as the Standard 
Print Unit (spr) 

Note 1: Tape units may be substituted for each of 
the functions of card reading, card punching, and 
printing. 

Note 2: At the option of the user, punch and 
printer output may be intermixed on one tape unit for 
subsequent off-line punching and printing on an ibm 
1401 Data Processing System. If the variable print and 
punch modules are selected, the Core Image file 
(mdm) and/or the Temporary Storage file (mdt) can 
also share this same tape unit. 

Note 3: At the option of the user, the standard 
print and/or standard punch capability may be elim- 
inated from the Resident Monitor. If no print unit 
is specified, (a) no diagnostic messages or memory 
map are provided by the Linkage Loader and (b) no 
compiler printed output is possible even though the 
compilers will operate. If no punch unit is specified, 
the compilers will operate, but no program cards will 
be produced. 

Tape-Oriented Systems 

In addition to the unit-record requirements, tape- 
oriented systems require: 

1 tape unit for a System Operating File ( sof ) 

1 tape unit for a Job file (mjb) 

1 tape unit for a System Library file if this file is not 
on the same reel of tape as the sof 

Note 1: If a Core Image file (mdm) is desired, an 
additional tape unit must be provided. This unit is not 
available for any other use unless the variable print 
and punch modules are selected. Selection of the vari- 
able print and punch modules allows the user to in- 
clude the mdm on the same tape unit containing the 
spr and spu. The mdm may be used for dumping 
error records. 

Note 2: The tape unit designated as the Job file 



is available as a work file if the program is loaded 
from the sof. 

Compiler Requirements: The three compilers (cobol, 
fortban, and Autocoder) share work files. The user 
may include any or all three compilers in his system. 
In addition to the requirements listed for a tape- 
oriented system, the compilers require: 

3 tape units used as work files for the Autocoder 
and cobol compilers, but 2 tape units for the 
Fortran compiler 
1 additional tape unit if the compile-and-go capa- 
bility is used 
Note: The tape designated as the Job file may be 
used as a work file during compilation. 

7307 Disk-Oriented Systems 

In addition to the unit-record requirements, 1301 disk- 
oriented systems require a series of contiguous cylin- 
ders formatted in the Load mode, one record per 
track, consisting of: 

1. Six cylinders for basic programs on the sof. 

2. Additional cylinders to accommodate: 
cobol— 3 cylinders 

Fortran— 2 cylinders 

Autocoder— 7 cylinders 

Utilities and Sort Definition Program— 1 cylinder 

Job file— Each cylinder can store approximately 
60,000 positions of core storage; e.g., 6 cylin- 
ders are required for disk-oriented System 
Generation 

Working storage used by the compilers— No less 

.than 2 cylinders per file and a greater number 

according to the size of the program being 

compiled (should not exceed 10 cylinders per 

file) 

User-supplied programs— Each cylinder can store 
approximately 60,000 positions of core storage. 

3. Five additional cylinders if the compile-and-go 
capability is used. These five cylinders can accommo- 
date approximately 4,400 subprogram card-image rec- 
ords that are the output from the compilers. (To 
increase this capacity, additional cylinders may be 
provided. Each additional cylinder can store approxi- 
mately 880 card-image records.) 

4. Cylinders to accommodate the System Library 
file of relocatable programs as follows: 

The ibmlibr requires 40 cylinders containing, in 
part, 1 cylinder for cobol subprograms and 4 
cylinders for Fortran subprograms. 

Additional cylinders for user-supplied subpro- 
grams (each cylinder can store approximately 
880 card-image records.) 



Note: If a Core Image file (mdm) is desired, and 
the variable print and punch modules have not been 
selected, a tape unit must be provided for the mdm. 
This unit is not available for other use. However, if 
the variable print and punch modules have been spec- 
ified, the mdm may share a tape unit with any com- 
bination of the following system files: Standard Print 
Unit, Standard Punch Unit, and Temporary Storage 
file (mdt). 

2302 Disk-Oriented Systems 

The differences between 1301 and 2302 disk-oriented 
systems are a result of the increased track capacity of 
the 2302 disk file. In addition to the unit record re- 
quirements, 2302 disk-oriented systems require a series 
of contiguous cylinders formatted in Load mode, two 
records per track. Each of these records forms a dis- 
tinct symbolic file. While the 2302 requires the same 
number of cylinders as the 1301 for system residence, 
proper balancing of files in disk storage (e.g., assign- 
ment of the System Library file to the second record 
per track, etc.) can reduce by half the number of 
tracks required by the 2302 disk file. 

Generalized Tape Sorting Program Requirements 

In addition to the requirements listed for tape- and 
disk-oriented systems, the Generalized Tape Sorting 
program requires a minimum of three tape units. For 
a tape-oriented system, these may be the same units 
used as work files by the compilers. Additional tape 
units may be used to increase the program's efficiency. 
(See the publication, Generalized Tape Sorting Pro- 
gram. ) 

Note: The tape unit designated as the Job file for 
the tape-oriented system may be used as one of the 
four tape units for the sorting program, if the sorting 
program is loaded from the sof. 

Generalized Sorting Program Requirements 

In addition to the requirements listed for a tape-ori- 
ented system, the Generalized Disk Sorting program 
requires 20,000 more positions of core storage and at 
least one module of ibm 1301/2302 Disk Storage. 

There are no additional machine requirements for 
using the generalized disk sorting program with a 
disk-oriented system. 

For both tape- and disk-oriented systems, optimum 
efficiency is-; provided by: (1) use of two modules of 
ibm 1301 Disk Storage; or (2) use of one module of 
ibm 2302 Disk Storage in which each access arm serv- 
ices a different work area. 

Requirements for File Organization System (FOS) 

An executable File Organization System requires the 
following minimum machine configuration: 
60,000 positions of core storage. 



One module of ibm 1301 or ibm 2302 Disk Storage. 

One magnetic tape unit (additional units are desir- 
able). 

An ibm 1402 Card Read-Punch and an ibm 1403 
Printer; or one or two magnetic tape units for the 
corresponding input/output functions. 

Tele-processing System Requirements 

Tape-Oriented Tele-processing Supervisor: 1 tape 
unit for storage of the tp Library file. 

1301 Disk-Oriented Tele-processing Supervisor: 1 
cylinder of disk storage, formatted in the Load mode, 
for storage of the Tele-processing Supervisor. 

If Tele-processing and batch processing occur con- 
currently, a tape-oriented system will require 60,000 
positions of core storage and a disk-oriented system 
will require 80,000 positions. Each system requires 
20,000 more positions of core storage than the mini- 
mum machine configuration needed for System Gen- 
eration. 

Additional cylinders of disk storage, formatted in 
the Load mode, for storage of tp programs. The effec- 
tive capacity of each cylinder is dependent upon the 
format used (i.e., relocatable or absolute) and the 
average size of the tp programs. 

To unload and reload the main-line program, the 
user must provide a tape unit or disk area for the 
Temporary Storage file (mdt). If the mdt is to be on 
tape, and the variable print and punch modules have 
been selected, the mdt may share the tape unit with 
any combination of the following system files: Stand- 
ard Print Unit, Standard Punch Unit, and Core Image 
file. 

Requirements for Systems Including the SPOOL Feature 

Use of the spool ( Simultaneous Peripheral Operations 
On Line) feature, which enables the user to perform 
such operations as card-to-tape and tape-to-card on 
line concurrently with regular processing, requires 
that the system contain a minimum of 60,000 positions 
of core storage. In addition, the Unit Record Priority 
Interrupt feature on the channel(s) used for spool 
must also be included. Other Operating System re- 
quirements are the same as those described above for 
the user's particular configuration. 

Requirements tor the Execution of Object Programs 

The machine requirements for the execution of object 
programs produced by the three compilers (cobol, 
Fortran, and Autocoder) vary according to the nature 
of the program, cobol and Fortran programs can refer 
to magnetic tape units and unit-record equipment. 
Autocoder programs can refer to disk storage and 
Tele-processing units as well as to magnetic tape units 
and unit-record equipment. 
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Basic Concepts — Tape-Oriented System 



This section applies only to a tape-oriented system 
and need not be read by persons interested only in a 
disk-oriented system. 



How f he System is Built 

Functions to be Performed 

The Master file contains an operating section capable 
of building an sgf. The sgf incorporates those options 
desired by the user. To build the sgf, several programs 
from the operating section, which are in absolute for- 
mat, are executed. These programs perform the fol- 
lowing functions: 

1. Accept input data that describes the environment 
under which the new system is to operate, and incor- 
porate the optional items defined by each user. 

2. Preserve, for later use, any or all of the library 
elements supplied on the Master file. 

3. Build the absolute programs that the user speci- 
fies. 

4. Place these absolute programs on the output file. 
At the time this operation is being performed, the 
library material preserved in step 2 can be merged 
onto the output file. At the same time, directories are 
merged onto the output file. 



work tape produced by sgi. The relocatable input that 
it processes comes from: 

1. The output of the Autocoder run; and 

2. The Relocatable Library supplied on the Master 
file. The output, in absolute form, is placed onto the 
Job file, mjb. 

SG2: This program produces the directories re- 
quired and merges the programs, directories, and 
libraries into the new file. 



Defining the System 

Each user must define, through control cards, the 
Operating System that he desires. A detailed descrip- 
tion of the control cards is presented in "System 
Description Control Cards" and "System Generation 
Control Cards." Briefly, the user specifies the follow- 
ing: 

1. The number and types of input/output devices. 
A two-character assignment symbol is specified by the 
user to be used in all references to each device. 

2. The variable and optional features desired within 
the Resident Monitor. 

3. The number and types of symbolic units required. 

4. The variable and optional features desired within 
the Resident iocs. 



Programs Required 

To perform the above functions, the following four 
programs are executed: 

AUTOCODER: The user describes the machine 
configuration and selects the various options from 
those available in the form of Autocoder source state- 
ments. Autocoder processes this input by means of 
macro routines and generates the nucleus of the new 
Monitor. 

SGI: This program performs two main functions. 

1. sgi locates and copies the library material that 
the user desires to include in the new system. 

2. sgi prepares a tape that contains input control 
information for the Linkage Loader (linkload pro- 
gram. ) 

LINKLOAD: This program performs its standard 
function of converting relocatable routines into ab- 
solute format. It reads control information from the 



Building an SGF 

This operation is the first step in System Generation. 
This section describes the steps leading to this initial 
sgf run. 

The user must give careful consideration to the 
various options available within the system. By choos- 
ing those options best suited to his needs, in addition 
to being aware of his installation's machine configura- 
tion, the user can prepare the control cards described 
in the section, "Organization of the Control Deck for 
the SGF." 

Construction of the File 

Each user must analyze his requirements for programs 
supplied to him on the Master file. The operating sec- 
tion of the Master file consists of the programs re- 
quired to do the initial run, Master to sgf. The operat- 
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ing section is used in conjunction with the Relocatable, 
Macro, and Create Libraries to construct the sgf. 

A user may choose to utilize one of the Create Li- 
brary packets that will generate a "standard set" of 
programs on the sgf. These programs are those that 
a typical user might require. 

If a specified requirement must be met which is not 
covered by a Create Library packet, the user must 
provide the appropriate Linkage Loader control cards. 
The packet, or the use of individual create capabili- 
ties, determines the ultimate sequence of programs on 
the sgf. 

Organization of the Control Deck for the SGF 

The control deck for this operation is composed of 
the following sections: 

1. Initialization, including the date card. The Moni- 
tor places the date from this card in a Resident Moni- 
tor field called /dat/. 

2. JOB. 

3. asgn cards assign symbolic unit entries to physi- 
cal input/output devices. 

4. mode card describes the program operation 
wanted for the job. 

5. exeq autocoder card causes the Monitor to locate 
and load the Autocoder processor. The card is fol- 
lowed by Autocoder source statements. These are 
macro statements that define the system. 

6. exeq sgi card causes the system to locate and 
load sgi. The cards which follow this exeq card are 
divided into two categories, sg control cards, Classes 
n, ni, and rv, instruct sgi to locate and copy libraries. 
creat control cards direct sgi to build a work file 
for the Linkage Loader. 

Note: creat control cards may be interspersed 
with (or replaced by) Linkage Loader control cards. 

7. exeq linkload card causes the Linkage Loader 
to be located and loaded. The Linkage Loader is 
directed to obtain its control information from the 
file just created by sgi. Output is placed on the Job 
file. 

8. exeq SG2 card causes SG2 to be located and 
loaded. The SG2 program has no control input. It can 
only be executed following one or more of the above 
programs that have prepared input data on prede- 
termined symbolic units. 

9. end. 

Additional information is given in the publication 
System Monitor. 

Example I 

Figure 1 illustrates the control cards needed to build 
a typical sgf. 
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OATE YRDAY 

JOB GENERATE TAPE ORIENTED SGF 
ASGN MW1 .84 
ASGN MB2.A5 
ASGN MW3.B5 
ASGN MJB.A1 
ASGN MR0.A3 
ASGN MG0.B2 
MODE GO.SG 

EXEQ AUTOCODER. . •NOFLG.NOPCH 
HEADRGENERATE SGF 
GEN01P1 ,R1 .XI 

GEN02/MDM/.1 .A0.A1 ■ A2 , A3 . A4 , AS . A6 , A7.A8.A9 
SEN0 2/MDM/.2.B0.B1 .82 . 63 , 34 .85 . B6 . E7 . B8 , B9 
GEN081700090119.,55.5.099,AO.R1.,,P1.X1.. .B6.SNAP 
GEN0910 

GEN1010.A4.B4.A5.B5.A6 
GEN1 1 

0EVDF1 .729.14 02.14 03 
DEVDF2.7330 

IOKDF1410,,A,4,5,, .,,70000 
END 

EXEQ SGI 7 

LOCATCCREATLIB 
tNSERC 

LOCATR, IBMLIBR 
INSERR 

LOCATM, AUTOCODER 
INSERM 
END 

CREATTSYSTEM 
END 

EXEQ LINKLOAD 
INPUTMW2 

EXEQ SG2 L7 

END 

Control Cards Required for a Typical sgf for a 
Tape-Oriented System 



The sample deck begins with the initialization in- 
formation. This is followed by the job card, asgn 
cards assign symbolic units to specific input/output 
devices through their assignment symbols. 

The mode card indicates that the output from any 
compiler is to be written on the Go file, mgo. This 
same card indicates that the operations that follow 
are to be executed in sg mode. This sets internal in- 
dicators that are tested by dependent programs and 
condition or alter their mode of operation. 

The exeq Autocoder card contains the fourth oper- 
and (noflg) and the fifth operand (nopch. ) The 
noflg operand is a signal to Autocoder that the source 
statements that follow will knowingly violate the rules 
governing use of index registers, hence flags that 
would normally be a diagnostic warning should be 
suppressed. The nopch parameter suppresses the 
punch output from this compilation. 

The first source card to Autocoder is a headr card, 
which serves to identify the run. 

By comparing the sample cards with the detailed 
description of the input control cards given later in 
this publication, the input to Autocoder can be seen 
to indicate the following: 

Unit record equipment will be available on channel 1. The Core 
Image file will always be available on the new system. 

Magnetic tape units will be available on two channels, ten tape 
units per channel. 

The system will be a 1410 Data Processing System. 

Core-storage size will be 80,000 positions. 

The system will be tape oriented. 

The system files will contain no tape labels. 

There will be no Tele-processing devices. 

The Core Image file ( MDM ) will be available. 

The POW program will not be included. 
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The Standard Print Unit will be a 1403 Printer. 

The Standard Punch Unit will be a unit-record punch. 

An Alternate Input Unit ( AIU ) will be included. 

The number of lines per page will be 55. 

The size of the console inquiry message area will consist of five 

core-storage positions. 
JOB cards will not be punched. 
All Monitor control cards will be typed and printed. 
The new system tape normally will be mounted on a tape unit 

whose assignment symbol is A0. 
The SIU will refer to Rl. 
The SPR will refer to PI. 
The SPU will refer to XL 
The Core Image file ( MDM ) will refer to B6. 
The Resident Monitor will include the Snapshot utility routine. 
Ten reserve units will be established. 
Ten work units will be established. 
The IOCS will provide routines for unit-record equipment and 

729 tape units on channel 1. 
The IOCS will provide routines for 7330 ( and 729 ) tape units 

on channel 2. 
The IOCS will have routines to check 120-character tape labels 

(no exits provided.) 
Error statistics are to be accumulated. 
User-written service routines will be provided for. 
The third record written on the Core Image file (MDM) will 

be written from location 70000. 
The last source statement to Autocoder is the END card. 

The exeq sgi card contains a 7 in column 59 to in- 
dicate the actual machine size. 

The control cards that follow the exeq sgi card re- 
quest sgi to copy the Create Library (cbeatlib), the 
Relocatable Library (ibmlibr), and the Macro Li- 
brary (which is a part of Autocoder.) These requests 
are terminated by the first end card. 

The second section of sgi control cards begins with 
the cheat tsystem card. This card requests sgi to 
locate the Create package specified and to produce 
control information for the Linkage Loader (linkload). 
The control information will be in the form of Linkage 
Loader control cards (e.g., phase, call, calln). 

This section is also terminated with an end card. 

The exeq linkload card is followed by the input 
mw2 card. The input card directs linkload to obtain 
its control information from the tape file MW2 pre- 
pared by sgi. 

The exeq sg2 card contains additional control 
punches: 

COLUMN CONTENTS 



58 



59 



Any character in this column indicates 
that the output should be constructed 
with "largest possible records." 
Character indicates the actual machine 



SG2 now merges the information processed above 
onto the new sgf. The sequence of the sgf is deter- 
mined by the sequence of information on the Job 
file, mjb. 

SG2 also processes requests contained on the Job file 
for directories and libraries. 

The final output, the sgf, appears on tape file mw2. 



Building an SOF 

This function is essentially a copy operation. Each 
item to be copied must be specifically requested. Any 
item(s) not specifically requested will not appear 
on the output file. 

Organization of the File 

In Example 1, the programs required for the sof run 
were converted into absolute format records. Hence, 
for this example, the most efficient way to produce the 
sof is to request that this file be constructed in the 
same sequence as the sgf. However, it is possible to re- 
sequence any or all of the operating section programs 
to produce a system that is most efficient from an 
operating viewpoint. In any case, the following pro- 
grams must appear first on the sof in the following 
order listed: 

IBBOOT 

IBRESMON 
IBTRANSIT 

Organization of the Control Deck for the SOF 

The control deck for this operation is composed of 
the following sections: 

1. Initialization, including the date card. 

2. JOB. 

3. asgn cards. 

4. exeq sgi. sgi control cards, Classes n, in, and rv, 
direct sgi to locate and copy libraries, sgi control 
cards, Class i, give the names of the specific items 
to be copied. Note that the sequence of these requests 
determines the sequence of the new file. 

5. exeq SG2. This card causes SG2 to build the final 
output tape. 

6. END. 

Example 2 

Figure 2 illustrates the control cards needed to build a 
typical sof. There is no card in the figure to declare 
mode sg; the sg mode is required only if the Linkage 
Loader is executed during system generation functions. 

The sample deck begins with standard initialization 
information, a job card, and asgn cards. 

The exeq sgi card used for this run does not require 
machine size indication in column 59; it is assumed 
that the sgf reflects the actual machine size. 

The exeq card is followed by requests to locate and 
copy the desired libraries. This section of control cards 
terminates with an end card. 

The next group of control cards contains specific 
requests to copy individual items from the input file. 
These requests determine the sequence of the final 
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MONSS 


DATE YYDDO 




MONSS 


JOB COPY SOF WITH MULTIPLE 


TRANSITIONAL MONITORS 


MONSS 


ASGN MW1.B1 




MONSS 


ASGN MW2.B2 




MONSS 


ASGN MJB.A1 




MONSS 


ASGN MR0.A3 




MONSS 


EXEO SGI 

LOCATR.IBMLIBR 

INSERR 

LOCATC.CREATLIB 

INSERC 

LOCATM. AUTOCODER 

INSERM 

END 

INCLDIBBOOT 

INCLDIBRESMON 

INCLDIBTRANSIT 

INCLDAUTOCODER 

INCLDIBTRANSIT 

INCLOLINKLOAB 

INCLDIBMLIBR 

INCLDIBTRANSIT 

INCLDUTILITIES 

INCLDSG1 

INCLOCREATLIB 

INCLDSG2 

INCLDIBTRANSIT 

INCLDFORTRAN 

INCLDIBTRANSIT 

INCLDSORTDEFINE 

INCLDIBTRANSIT 

END 




MONSS 


EXEO SG2 




MONSS 


END 





Figure 2. Control Cards Required for a Typical sof for a 
Tape-Oriented System 

output file (sof). Contained in this group are specific 
requests to include (incld) the ibmlibr and the 
creatlib. These cards are required to establish the 
relative location of these items, sgi will prepare a re- 
quest ( for SG2 ) to show the location desired. Note that 
several copies of ibtransit have been requested. The 
group of control cards also terminates with an end 
card. 

The exeq SG2 card causes SG2 to build the final out- 
put tape. The functions performed by this program are 
the same as those outlined in Example 1. 



Addition of a User-Written Program 

An operation that is frequently carried out is the addi- 
tion of a user-written program to the operating section 
of an sof. This function, like the previous illustrations, 
involves the building of a new system tape. 

Organization of SOF to be Updated 

To accomplish the updating of a system, the full capa- 
bilities of sgi can be employed. Therefore, the user 
may choose to resequence the operating section of the 
new sof. The only restriction on sequencing is that 
ebboot, ibresmon, and ibtransit must be the first 
items on the output file. 

Organization of the Control Deck 

Control cards follow the pattern established in Ex- 
ample 2 when adding additional programs to the sof. 
However, additional cards are required to: 
1. Establish mode sg; and 



2. Add the additional program, and resume the 
normal sgi functions. 

The sequence of the final output is determined from 
the sequence of the Job file. Because of this, the loca- 
tion of the additional cards is important. 

The first exeq sgi card begins requests that preserve 
the library elements that are to be retained. This sec- 
tion terminates with an end card. 

The incld cards direct sgi to build a Job file in the 
sequence specified. At the point where the new pro- 
gram^) are to be inserted, sgi functions are termi- 
nated (temporarily) by an end card. 

The card exeq linkload, followed by the necessary 
control information and input deck(s), build the new 
program(s) onto the Job file. 

At the completion of linkload, the exeq sgi card 
appears again to cause the resumption of normal proc- 
essing. This causes the remaining programs to be 
placed on the Job file. 

Example 3 

Figure 3 illustrates the addition of a user-written pro- 
gram to the operating section of an sof. 

The sample deck begins with the date, job, and 
asgn cards. 

The mode sg card establishes the mode for the pro- 
grams that follow. This alters the normal operation of 
linkload so as to cause it to record information on a 
work file for SG2. 

exeq sgi is followed by requests to preserve library 
material. This section terminates with an end card. 

The next cards are sgi Class i requests to copy pro- 
grams from the operating section on the Job file. This 
section is also terminated with an end card. 

The exeq linkload card is followed by Linkage 
Loader control and input cards. In this example, the 
user's program has been previously compiled, and the 
relocatable deck from the compilation is placed im- 
mediately after the phase card. The user-written pro- 
gram resides on the lib or Go file as well as on the siu. 

The exeq sgi card is required only if it is necessary 
to resume the sgi function. In this example, sgi is re- 
quired because the new program to be inserted was 
not to be at the end of the Job file. 

Additional sgi Class i cards follow, specifying the 
programs to be copied onto the Job file. This section 
terminates with an end card. 

Note: At this point, the Job file is in the sequence 
desired for the output file. 

The exeq sg2 card causes sg2 to build the new tape 
in the same sequence as the Job file. At this time, 
library information and directories are merged onto 
the new tape wherever they have been requested. 
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DATE YYDDO 


MONSS 


JOB UPDATE DECK 


MONSS 


ASGN MJ3.A1 


MONSS 


ASGN MRO.A3 


MONSS 


ASGN MW1.B4 
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ASGN MW2.A5 
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MODE SG 


MONSS 


EXEQ SGI 




LOCATR.IBMLIBR 




INSERR 




LOCATM. AUTOCODER 




INSERM 




END 




INCLDIBBOOT 




INCLDIBRESMON 




INCLDIBTRANSIT 




INCLDAUTOCODER 




INCLDLINKLOAD 




INCLDIBMLIBR 




END 


MONSS 


EXEO LINKLOAD 




PHASEUSERPROG 


***»»*****»**RELOCATABLE oeck»»*»»******** 


MONSS 


EXEO SGI 




1NCLDSORTDEF1NE 




INCLDIBTRANSIT 




END 


MONSS 


EXEO SG2 
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END 



Figure 3. Control Cards Required to Add a User- Written 
Program to the sof of a Tape-Oriented System 



General Maintenance Considerations 

Maintenance of the operating system covers many 
possible variations. Listed below are some of the im- 
portant aspects: 

Change to Monitor: Requires complete regenera- 
tion of the sgf, sof, all Job files that have been saved, 
and all tp Library files. 

Change to a Dependent Program in the Operating 
Section: Requires recompilation of affected modules, 
copying (incld) any unaffected programs, and regen- 
eration of affected programs. 

Change to Library (other than Monitor library ele- 
ments): Requires updating of library, plus regenera- 
tion of any programs in the operating sections which 
were affected. As in item 2, any unaffected programs 
can be copied by use of the incld card. By careful 
planning, the user should be able to make changes to 
an existing relocatable library and also incorporate 
those changes into a new operating section as part of 
one job. For this type of operation, the reader should 
review the control card descriptions concerning the 
operation of the Go file during maintenance of the Re- 
locatable Library. Refer to Class iv control cards inseb 
and replc, under "System Generation Control Cards." 

Instead of the above method, the SG4 and sgs pro- 
grams can be used to update the libraries as described 
in the section "System Maintenance." Each time the 
library modules are to be updated, ibm supplies a tape 
containing the changes to be made. This tape is used 
with the sgs program to prepare an input tape for 



updating the libraries. If the user must make his own 
changes to ibm program modules, he can use the SG4 
program for making the changes to the modules and 
for maintaining the modules. 

A careful study of the control card descriptions is 
required to utilize the maintenance capabilities effi- 
ciently. 



Check List for System Generation (Tape- 
Oriented) 

1. The programs in System Generation use the last 
(highest) core-storage position as a starting point 
from which certain elements are built. 

2. The absolute records size option (exeq sg2 card) 
for systems that include Tele-processing devices 
should not specify largest possible records. 

3. The Sort Definition program should be generated 
by the initial generation if sort or merge programs are 
desired on an sof. 

4. Multiple copies of the Transitional Monitor 
should be placed on the sof to minimize the search 
time required for this element during operation. The 
Resident Monitor always makes a forward search for 
the Transitional Monitor. Multiple copies of any pro- 
gram can be placed on the sof to minimize search 
time. If multiple copies are included, they must be 
identical. For example, if one copy of Linkage Loader 
includes couple, all copies must include couple. Also, 
the user can create multiple copies of Transitional 
Monitor in the same run that Resident Monitor is gen- 
erated. This is done by inserting creattransit cards 
at the desired insertion points. 

5. The user can modify the Macro Library and the 
Create Library, but cannot create additional libraries 
with records of the same format as these libraries. A 
Relocatable Library can also be modified and the user 
can create as many relocatable libraries as desired, 
with the one restriction that only one of these can be 
named ibmltbr (or any other name.) tjbmlibr is the 
name used by the Linkage Loader to find the System 
Library file if the user does not specify a different one. 
For relocatable libraries on separate reels, any name, 
including ibmlibr, can be assigned. 

6. cobol and Autocoder use symbolic units mwi, 
mws, and MW3 for work files during compilation; 
Fortran uses mwi and MW2. mwi and MW3 should 
be assigned to a different channel from MW2 for bal- 
anced and efficient usage. One additional tape unit is 
required if the compile-and-go capability is used. 

7. The Create Library must be named creatltb. 

8. If the cobol "enter" verb is used in conjunction 
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with Fortran subprograms, the relocatable modules 
required to run with cobol and Fortran object pro- 
grams must be in the same Relocatable Library. 

9. Every system must have the Bootstrap, the Resi- 
dent Monitor, and the Transitional Monitor (in that 
order) at the beginning of the tape. 

10. The maximum number of items that may ap- 
pear on an sof is 154. An item is defined as a program 
or a library. (Examples: cobol is one item and ebmlibr 
is one item.) 

11. Table 1 indicates the asgn cards that are re- 
quired during System Generation. 

12. The Generalized Tape Sorting program requires 



a minimum of four tape units (including the sof). 
These may be the same tape units as those used as 
work files by compilers. Additional tape units increase 
the program's efficiency. See the publication Gener- 
alized Tape Sorting Program. 

13. The Generalized Disk Sorting Program requires 
two disk work areas, preferably on separate modules. 
Any tape units used must be in addition to the basic 
requirements for the system. See the publication Gen- 
eralized Sorting Program Using IBM 1301/2302 Disk 
Storage. 

14. Programs that require the Autocoder "No-Clear" 
option for da statements must not be placed on the sof. 



Table 1. Tape System Input/Output Requirements 




,_ 


, 


, 


, 






Physical Unit 


1 


2 


3 


4 


5 


6 


7 


8 


9 


Symbolic Unit 


SOF 


SIU 


MWI 


MW2 


MW3 


MJB 


MGO 


MRO 


SPR 


c 



e s. 

a. 1/1 


Autocoder 


■ 


i 

3 

) 

5 

\ 

r 


i 

- 


1 

3 

> 

f 


Work File 


Work File 


Work File 




Output 




,i 


SGI 


Library 
Directory 
Work File 


Linkage 
Loader 
Input File 




Output 


From 
Autocoder 




SORT- 
DEFINE 




Linkage 
Loader 
Input File 






Not 
Used 




c 

,0 
Q. 

o 


LINKLOAD 


Library 
Directory 
Work File 


Linkage 
Loader 
Input File 




Output 


From 
Autocoder 




' 




SG2 


Library 
Directory 
Work File 


New SOF 
(Final Out- 
put File) 




Input 




Directory 
Work File 



For the minimum configuration, MW3 and MJB, and MGO and MRO share the same physical units. 
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Basic Concepts — Disk-Oriented System 



This section applies only to a disk-oriented system and 
need not be read by persons interested only in a tape- 
oriented system. 



How the System is Built 



The output, in absolute form, is placed onto the 
Job file, mjb. 

SG2: This program locates and copies the library 
elements that the user desires in the new system. Its 
output is a new tape that is capable of being loaded 
onto the disk. This tape contains all items generated. 



Functions to be Performed 

The Master file contains a bootstrap disk load program 
that loads the Master file on the disk in preparation 
for System Generation. The absolute portion that is 
loaded on the disk is capable of building an sgf. The 
sgf incorporates those options desired by the user. To 
build the sgf, several programs from the operating 
section, which are in absolute format, are executed. 
These programs perform the following functions: 

1. Accept input data that describes the environment 
within which the new system is to operate, and in- 
corporate the optional items defined by each user. 

2. Build absolute programs that the user specifies. 

3. Place these absolute programs on the output file. 

4. Place the library elements on the output file. 

Programs Required 

To perform the above functions, the following four 
programs are executed: 

AUTOCODER: The user describes the machine 
configuration and the various options available in the 
form of Autocoder source statements. Autocoder proc- 
esses this input by means of macro routines and gen- 
erates the nucleus of the new system. 

SGI: This program performs one function. It pre- 
pares a tape which contains input control information 
for the Linkage Loader (linkload program). 

LINKLOAD: This program performs its standard 
function of converting relocatable routines into ab- 
solute format. It reads control information from the 
work tape produced by sgi and/or control cards from 
the siu. The relocatable input that it processes comes 
from: 

1. The output of the Autocoder run (item 1 above); 
and 

2. The Relocatable Library supplied on the Master 
file. (This library must have been loaded onto the 
disk.) 



Defining the System 

The user must describe the Operating System that he 
desires through control cards. A detailed description 
of the control cards appears in "System Description 
Control Cards" and "System Generation Control 
Cards." 

Briefly, the user supplies the following: 

1. The number and types of input/output devices. A 
two-character assignment symbol is specified by the 
user to be used in all references to each device. 

2. The variable and optional features desired within 
the Resident Monitor. 

3. The number and types of symbolic unit entries 
required. 

4. The variable and optional features desired within 
the Resident iocs. 



Preparing to Build an SGF 

Before building an sgf or sof, it is necessary for the 
user to load the Master file or the source sgf onto disk 
storage. Instructions for performing this transfer to 
disk storage are given in "Disk Load Program." 

After the Master file is loaded onto the disk, it is 
necessary to format the disk areas required for the 
files (mjb, mgo, mwi, MW2, and MW3) used during 
System Generation. This is accomplished by using the 
1301 or 2302 Format/ Address Generator utility pro- 
grams. See the publication IBM 1410/7010 Operating 
System; Utility Programs, Form C28-0353, for instruc- 
tions in the use of these programs. 



Building an SGF 

This operation is the first step in System Generation. 
This section describes the steps leading to this initial 
sgf run. 
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The user must give careful consideration to the 
various options available within the system. By choos- 
ing those options best suited to his needs, besides 
being aware of his installation's machine configuration, 
the user can prepare the control cards discussed in 
the section, "Organization of the Control Deck for 
the SGF." 

Construction of the File 

Each user must analyze his requirements for programs 
supplied to him on the Master file. The operating sec- 
tion of the Master file consists of the programs re- 
quired to do the initial run, Master to sgf. The oper- 
ating section is used in conjunction with the Relocat- 
able, Macro, and Create Libraries to construct the sgf. 

A user may choose to utilize one of the Create Li- 
brary packets that will generate a "standard set" of 
programs on the sgf. These programs are those that 
a typical user might require. 

If a specific requirement must be met which is not 
covered by a Create Library packet, the user must 
provide the appropriate Linkage Loader control cards. 

Organization of the Control Deck for the SGF 

The control deck for this operation is composed of 
the following sections: 

1. Initialization, including booti card and the date 
card. The Monitor places the date from the date card 
in a Resident Monitor field called /dat/. Figure 4 
shows a 1410 bootstrap card for channel 2. 

2. JOB. 

3. asgn cards assign symbolic unit entries to physi- 
cal input/output devices. 

4. mode card describes the program operation 
wanted for the job. 

5. exeq autocoder card causes Monitor to locate 
and load Autocoder. The card is followed by Auto- 
coder source statements. These cards define the system. 

6. exeq sgi card causes the system to locate and 
load sgi. The cards that follow this exeq card must be 
Class m sg control cards, creat control cards direct 
sgi to create a work file for the Linkage Loader. 

Note: sg control cards, Class in, may be inter- 
spersed with (or replaced by) Linkage Loader con- 
trol cards. 

7. exeq linkload card causes the Linkage Loader 
to be located and loaded. The Linkage Loader is 
directed to obtain its control information from the file 
just created by sgi. 

8. exeq SG2 card causes sg2 to be located and loaded. 
The cards that follow this exeq card are divided into 



two distinct groups. The first group consists of Class I 
sg control cards only. The Class i control cards direct 
sg2 to locate the named elements and to copy them 
onto the new output file. 

The second group is made up of Class n, in, and rv 
control cards. (Class rv control cards must be last.) 
This group directs sg2 to perform some operations on 
the libraries and to copy those libraries onto the new 
output file after the operations requested are complete. 

9. END. 

Additional information is given in the publication 
System Monitor. 

The newly created output file is a tape. To use this 
new system it is necessary to load this tape onto disk. 
See "Disk Load Program" for instructions. 

Example I 

Figure 4 illustrates the control cards needed to build 
a typical sgf. 

The sample deck begins with the normal initializa- 
tion information. The first card contains the bootstrap 
that loads the first record of the system into core 
storage. This is followed by the job card, asgn cards 
assign symbolic units to specific input/output devices 
through their assignment symbols. 

The mode card indicates that the output from any 
compiler is to be written on the Go file, mgo. This 
same card indicates that the operations that follow 
are to be executed in sg mode. This sets internal in- 
dicators which are tested by dependent programs and 
which condition or alter their mode of operation. 

The exeq autocoder card contains the fourth oper- 
and (noflg) and the fifth operand (nopch). The 
noflg operand is a signal to Autocoder that the source 
statements that follow will knowingly violate the rules 
governing use of index registers; hence flags that 
would normally be a diagnostic warning should be 

suppressed. The nopch parameter will suppress the 
punch output from this compilation. 

The first source card to Autocoder is a headr card, 

which serves to identify the run. 

By comparing the sample cards with the detailed 

descriptions of the control cards that appear later in 

this publication, the input to Autocoder will be seen 

to indicate the following: 

Unit record equipment will be available on channel 1. 

Magnetic tape units will be available on two channels, two tapes 
per channel. 

Nine disk files are defined on both channel 1 and channel 2. 

The system will be a 1410 Data Processing System. 

The core-storage size will be 80,000 positions. 

The system will be disk oriented. 

The system files will contain no tape labels. 

There will be no Tele-processing devices. 
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INSERT 


BOOTSTRAP CARD »»» 




MONSS 


DATE VRDAY 




MONSS 


JOB GENERATE DISK SGF 




MONSS 


ASGN LIB.E2 




MONSS 


ASGN MJB.E3 




MONSS 


ASGN MG0.E4 




MONSS 


ASGN MW1 ,E5 




MONSS 


ASGN MW2.E6 




MONSS 


ASGN MW3.E7 




MONSS 


MODE GO.SG 




MONSS 


EXEQ AUTOCODER. . .NOFLG.NOPCH 
HEADRGENERATE DISK SGF 
GEN01P1 .Rl.XI 
GEN02, 1 .AO.A1 
GEN02.2.B0.B1 






GEN03E 1,0000 0000, 21 99. E2, 00220000, 2599, E3, 


.00260000,2999, 




E4, 0030 00 00, 33 99, E5, 00340000. 3799. E6, 


.00380000,4199. 




E7, 0042 0000. 4599, E8. 00460000. 4999. E9, 


,00500000,5399 




GEN04G 1.0000 000 0,2 I 99, G2, 0022 0000. 2599, G3, 


,00260000,2999, 
,00380000,4199', 




G4, 0030 0000. 3399. G5. 00 340000. 3799. G6i 




G7, 0042 00 00, 4599, G8 .00460000, 4999, G9, 


,00500000,5399 




GEN081790000 110, . 55, 20, 99. El. Rl,,, PI, XI 






GEN0910 






GEN1010.E4,G1,E6,E5.G2 






GENII 






DEVDF 1.729, 1402, 1403 






0EVDF2,7330 






DSKDF1.00 






DSKDF2.0 












END 




MONSS 


ASGN MW2.A2 




MONSS 


EXEQ SGI 

CREATDSYSTEM 

END 




MONSS 


EXEQ LINKLOAD 
INPUTMW2 




MONSS 


EXEQ SG2 

LOCATM.MACROLIB 

INSERM 

LOCATC.CREATLIB 

INSERC 

LOCATR, IBMLIBR 

INSERR 

END 




MONSS 


END 





Figure 4. Control Cards Required for a Typical sgf for a Disk-Oriented System 



The Core Image file will not be available. 

The POW program will not be included. 

The Standard Print Unit will be a 1403 Printer. 

The Standard Punch Unit will be a unit-record punch. 

AIU capability will not be included. 

The number of lines per page will be 55. 

The console inquiry message area will consist of 20 positions of 

core storage. 
JOB cards will not be punched. 

All Monitor control cards are to be typed and printed. 
The new system will normally be available in the disk area 

whose assignment symbol is El. 
The SIU will normally refer to Rl. 
The SPR will refer to PI. 
The SPU will refer to XI. 
Ten reserve units will be established. 
Ten work units will be established. 
The IOCS will provide routines for unit-record equipment and 

729 tape units on channel 1. 
The IOCS will provide routines for 7330 (and 729) tape units 

on channel 2. 
The IOCS will provide for one module of disk on both channel 

1 and channel 2. 
Write disk checks will be performed. 
The last source statement to Autocoder is the END card. 

The exeq sgi card contains a 7 in column 59 to in- 
dicate the actual machine size. 

The sgi control cards begin with the cheat dsystem 
card. This card requests Create Library package 
dsystem and produces control information for the 
Linkage Loader. The control information will be in 
the form of Linkage Loader control cards. 



The sgi control cards terminate with an end card. 

The exeq linkload card is followed by the input 
mw2 card. The input card directs linkload to obtain 
its control information from the tape file MW2 pre- 
pared by sgi. 

The exeq SG2 card contains an additional control 
punch: 

COLUMN CONTENTS 

59 7 Character indicates the actual machine 

size. 

SG2 now produces a new output tape on tape file 
MW2. The order of the disk file, except for the posi- 
tion of the relocatable library, is not important in a 
disk-oriented system because of the random access 
capability of disk storage. The newly created output 
file is on tape unit mw2. To use this new system, it 
is necessary to load this tape onto the disk. (See "Disk 
Load Program" for instructions.) 



Building an SOF 

This operation is essentially a "copy" function. Each 
item to be copied must be specifically requested. Any 
item(s) not specifically requested will not appear on 
the output file. 
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Organization of the File 

In Example 1, the programs required for the sof run 
were converted into absolute format. 

A consideration for constructing a disk sof is to 
eliminate elements from the system so that less disk 
storage is required. Less disk area occupied by the 
system means that there will be more data area space 
available for production jobs. 

Organization of the Control Deck for the SOF 

The control deck for this operation is composed of the 
following sections: 

1. Initialization, including the date card. 

2. JOB. 

3. asgn cards assign symbolic units to physical in- 
put/output devices. 

4. mode card describes the program operation 
wanted for the job. 

5. exeq sgi card causes the system to locate and 
load sgi. The cards that follow this exeq card must be 
Class in sg control cards. These control cards instruct 
sgi to create a work file for the Linkage Loader. 

Note: sg control cards, Class in, may be inter- 
spersed with (or replaced by) Linkage Loader control 
cards. 

6. exeq linkload card causes the Linkage Loader 
to be located and loaded. This exeq card is followed 
by a control card which instructs the Linkage Loader 
to obtain its control information from the file just 
created by sgi. In a disk-oriented system, only one 
exeq linkload card may appear in the control card 
deck for each generation. 

7. exeq sg2 card causes SG2 to be located and 
loaded. The cards that follow this exeq card are di- 
vided into two distinct groups. The first group consists 
of Class i sg control cards only. The Class i control 



cards direct SG2 to locate the named elements and to 
copy them onto the new output file. The second group 
is made up of Class n, m, and rv sg control cards. (Class 
iv control cards must be last. ) This group directs SG2 
to perform some functions with the libraries and to 
copy those libraries onto the new output file after the 
function requested is complete. 

8. end. 

The newly created output file is a tape. In order 
to use this system it will be necessary to load this tape 
onto disk storage. ( See "Disk Load Program" for in- 
structions. ) 

Example 2 

Figure 5 is an example that illustrates the control 
cards needed to build a typical sof. Inclusion of a 
user-written program in the sof is shown. 

The sample decks begin with standard initialization 
information. This is followed by the job card. The 
mode card sets an internal indicator that is tested by 
the dependent programs that must alter their method 
of operation for System Generation mode. 

The group of asgn cards assigns the required files 
that are to be used for this job. 

The exeq card for this run does not require machine 
size indication in column 59; it is assumed that the sgf 
reflects the actual machine size. 

The control cards that follow the exeq sgi card 
request sgi to extract the control information from the 
Create Library packet named dfobtran, and to pass 
this information to the Linkage Loader via tape file 

MW2. 

The exeq linkload is followed by the input MW2 
card. The input card directs the Linkage Loader to 
obtain its control information from tape file MW2, as 
prepared by sgi. At the end of file on MW2, the Link- 
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•»» INSERT BOOTSTRAP CARD »•• 
MONSS 



MONSS 
MONS* 
MONSS 
MONSS 
MONSS 
MONSS 



JOB E CREATE DISK SOF ORIENTED TO USER PROGRAM AND FORTRAN 



MODE SG 

ASGN LIO.E2 

ASGN MJB.E3 

ASGN MW2.A1 

EXEQ SGI 

CREATDFORTRAN 

END 
MONSS EXEQ LINKLOAO 

INPUTMW2 

PHASEUSERNAME 
••»« RELOCATABLE DECK FOR USER PROGRAM *«» 
MONSS EXEQ SG2 

INCLDIBSGDL 

INCLD1BBOOT 

INCLDLINKLOAO 

END 
FORTRANLIBLOCATR. IBMLIBR 
IBSRTCOMANDELETR. IBCBLDVZER 
IBRANDOM DELETR.TPRDLIBGEN 

END 
MONSS END 

Figure 5. Control Cards Required for a Typical sof for a Disk-Oriented System 
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age Loader returns to the siu and gets the control 
information to process the user-written program. 

The first group of cards presented to sg2 are Class i 
control cards. They indicate to SG2 that the programs 
named are to be copied from the sgf to the new mas- 
ter tape file. After the three named programs are 
copied, SG2 will copy the Fortran and the user-written 
programs that were just placed on the Job file by the 
Linkage Loader. 

The next group of cards directs SG2 to locate ibmlibr, 
change its name to fortranlib, and to delete from 
this library the named routines and those that exist 
between the given names. The new fortranlib is 
then copied onto the new master tape. 

When the end card is read, the new file is produced 
by SG2 and a message is typed stating the unit on which 
the output file, mw2, is located. See "Disk Load Pro- 
gram" for a description of how to load this new file 
onto the disk. 



Shared Disk Files 

Four basic iocs generations are available (on a per 
channel basis) for a shared disk file environment. The 
basic generations may be used in many combinations 
in the sharing systems ( see "Permissible Combinations 
of Generations" in this section ) . 

Four IOCS Generations 

The four types of generations available, and their arbi- 
trary designations (Type A, Type B, etc.), are as 
follows: 

1. No Arm Sharing (Type A): Type A generation is 
suited to applications where the systems share the 
same ibm 7631 File Control unit, but do not compete 
for the same disk arm(s). A system using Type A gen- 
eration should not share the file control unit with a 
system using any other type of shared-file generation. 

2. Arm Sharing (Type B): Type B generation is 
suited to applications where the systems share the 
same ibm 7631 File Control unit and compete for the 
same disk arm(s). Under Type B generation, one sys- 
tem gains control of the file control unit and uses the 
shared disk file; the other system may perform other 
input/output operations and/or other processing until 
the first system has released control of the file control 
unit. 

3. Arm Stealing— Priority (Type C): Type C genera- 
tion is similar to Type B generation in that both sys- 
tems share the same ibm 7631 File Control unit and 
compete for the same disk arm(s). In Type C genera- 
tion, however, input/output requests to a shared disk 



temporarily controlled by the other system that shares 
the disk are issued repeatedly until the requests can 
be serviced; no other input/output operations or other 
processing can be performed. Type C generation is 
suitable for high-priority operations that must be serv- 
iced at the possible expense of other input/output op- 
erations or other processing. 

4. Arm Stealing-No Priority (Type D): Type D 
generation is a logical counterpart of Type C genera- 
tion. In Type D generation, control of the file control 
unit is relinquished whenever possible to enable serv- 
icing of higher priority requests (e.g., those initiated 
from a Type C generation). 

Permissible Combinations of Generations 

The permissible combinations of iocs generations for 
two ibm 1410/7010 Data Processing Systems sharing 
an ibm 7631 ( Model V) File Control unit are indicated 
in the following list. 

Note: "System not using disk" means that a Prevent 
Seek Complete instruction (or its equivalent) has been 
executed and that either (1) the system has an iocs 
with disk capabilities, but does not issue disk com- 
mands, or (2) the system's iocs has no disk capabilities. 
ibm 1410/7010 ibm 1410/7010 

SYSTEM 1 SYSTEM 2 

Normal (not shared) disk IOCS System not using disk 

Type A System not using disk 

Type A Type A 

Type B System not using disk 

Type B Type B 

Type B Type C 

Type B Type D 

Type C System not using disk 

Type C Type C 

Type C Type D 

Type D System not using disk 

Type D Type D 

For an ibm 1410/7010 Data Processing System and 
some other ibm 7000 Series Data Processing System 
sharing an ibm 7631 (Model III) File Control unit, one 
combination of iocs generations is permitted: a Type 
A generation for the ibm 1410/7010 system and an 
equivalent generation for the other system sharing the 
file. If the latter system is not using the disk, the ibm 
1410/7010 can use any iocs generation (e.g., Types B 
or C). 

Specifying Generation Desired 

Specification of the type of iocs generation desired in 
a shared disk environment is made in the dskdf macro- 
instruction described under "Disk Definitions for Resi- 
dent iocs (dskdf)." In this specification, the channel 
number is prefixed with the type designation (A, B, 
etc. ) of the generation desired. 
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General Maintenance Considerations 

Maintenance of the Operating System covers many 
possible variations. Listed below are some of the im- 
portant aspects: 

Change to Monitor: Requires complete regenera- 
tion of the sgf, sof, all Job files that have been saved, 
and all tp. Library files. 

Change to a Dependent Program in the Operating 
Section: Requires recompilation of affected modules, . 
copying (incld) any unaffected programs, and re- 
generation of affected programs. 

Change to Library (other than Monitor library ele- 
ments): Requires updating of library, plus regenera- 
tion of any programs in the operating section which 
were affected. As in above item, any unaffected pro- 
grams can be copied by use of the incld card. By care- 
ful planning, the user should be able to make changes 
to an existing relocatable library and also incorporate 
those changes into a new operating section as part of 
one job. For this type of operation, the reader should 
review the control card descriptions of the operation 
of the Go file during maintenance of the Relocatable 
Library. Refer to Class rv control cards inseb and 
beplc, under "System Generation Control Cards." 

Instead of the above method, the SG4 and sgs pro- 
grams can be used to update the libraries, as described 
in the section "System Maintenance." Each time the 
library modules are to be updated, ibm supplies a tape 
containing the changes to be made. This tape is used 
with the sgs program to prepare an input tape for up- 
dating the libraries. The program has an option that 
permits it to be used with a minimum disk system 
having only one tape unit available to the Operating 
System program. If the user must make his own 
changes to ibm program modules, he can use the SG4 
program for making the changes to the modules and 
for maintaining the modules. 

A careful study of the control card descriptions is 
required to utilize the maintenance capabilities effi- 
ciently. 

Check List for System Generation 
(Disk-Oriented) 

1. The programs in System Generation use the last 
(highest) core-storage position as a starting point 
from which certain elements are built. 

2. The Sort Definition program should be gener- 
ated by the initial generation if sort or merge programs 
are to be created on an sof. 

3. The user can modify the Macro Library and the 
Create Library, but cannot create additional libraries 
with records of the same format as these libraries. A 



Relocatable Library can also be modified. The library 
must be loaded onto the lib file when the system is 
loaded on the disk. 

4. cobol and Autocoder use symbolic units mwi, 
mw2, and MW3 for work files during compilation; for- 
tban uses mwi and mw2. mwi and MW3 should be 
assigned to a different channel and/or module from 
mw2 for balanced and efficient usage of the 1301 disk. 

5. The Create Library must be named creatltb, and 
the Macro Library must be named macroltb. 

6. If the cobol "enter" verb is used in conjunction 
with Fortran subprograms, the relocatable subpro- 
grams required to run with cobol and Fortran object 
programs (refer to "Relocatable Library Contents") 
must be in the same relocatable library. 

7. The order of elements on the disk is of little im- 
portance because of the random access nature of the 
device. However, the placement of some of the ele- 
ments on the output tape, which contains the system, 
can be critical, and the following points should be 
observed: 

a. The first program on the tape must be ibsgdl. 
This is the Disk Load program. 

b. The second program must be dbboot. ibboot, 
for a disk-oriented system, comprises a boot- 
strap program (ibboot2d), the Resident Moni- 
tor, and the Transitional Monitor. 

c. The remaining programs may be in any order 
if they have been included from an existing 
sgf. If the system that is being built is to be 
capable of generating another system, ibsgdl 
must be included again. 

d. If an entire system is being generated, D3SGDL 
must be generated as the first program. Also, 
if the entire system being generated is to be 
capable of generating another system, then the 
ibsgdl program must also be generated last. 

8. Table 2 indicates the asgn cards that are required 
during System Generation. 

9. The Generalized Tape Sorting program requires 
a minimum of four tape units (including the sof). 
Additional tape units increase the program's efficiency. 
See the publication Generalized Tape Sorting Pro- 
gram. 

10. Each initialization of a disk system requires that 
the booti card be first in the sru. The contents of this 
card are typed on the console printer during system 
loading. The operator key punches the card and places 
it in the siu. 

11. The Generalized Disk Sorting Program requires 
two disk work areas, preferably on separate modules. 
Any tape units used must be in addition to the basic 
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requirements for the system. See the publication Gen- 
eralized Sorting Program Using IBM 1301/2302 Disk 
Storage. 



12. Programs that require the Autocoder "No-Clear" 
option for da statements should not be placed on the 

SOF. 



Table 2. Disk System Input/Output Requirements 
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System Generation Considerations 



Organization of Data Files on IBM 1301 or 2302 
Disk Storage 

Prior to System Generation, organization of disk stor- 
age must be determined; assignment symbols for the 
physical units into which each disk storage module is 
divided must be selected, and the disk must be for- 
matted. The Input/Output Control System for the 
ibm 1410/7010 Operating System provides for a num- 
ber of methods of organizing a disk file. 

Since almost all uses of the disk by system files re- 
quire Form G (Partitioned Sequential-Geometric) disk 
files, this form is discussed here. For example, the sof, 
compiler work files, the library, and the Go and Job 
files are Form G files. 

Form G (Partitioned Sequential-Geometric) makes 
it possible for more than one logical file to share the 
storage area available on one or more cylinders; the 
record sizes of the different files need not be the same. 
This can appreciably reduce seek time. 

Figure 6 depicts a use of Form G. The outside cyl- 
inder, cylinder 000, is assigned to work files MW7, 
mws, and MW9 by the control cards shown below. 



6 


16 


?1 




MCN«* 


ASGN 


MW7 


A1.A2 


M0N$* 


ASGN 


MW8 


A3 


MQN*$ 


ASGN 


MW9 


A*,A5 



Outside cylinder, 000 (Track 
addresses 0000-0039) 




The relation between the assignment symbols Al 

through A5 and the physical units must have been 

established during System Generation (see the section, 

"System Description Control Card"). During System 

Generation: 

Al was specified as 00000000 to 00003900 
A2 was specified as 00000001 to 00003901 
A3 was specified as 00000002 to 00003902 
A4 was specified as 00000003 to 00003903 
A5 was specified as 00000004 to 00003904 

The Form G address format of these disk areas is: 



250 cylinder positions 



40 disk surfaces 
available to read- 
write heads at each 
track position 



Assignments: 
Al - MW7 
A2 - MW7 Alt. 
A3 - MW8 
A5-MW9Alt. 
A4 - MW9 

Figure 6. 
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Access Mechanism 



Example of a Disk Module Organized for Form 
G Files 



For the example discussed here, access and module 
(am) are assumed to be 00. In the Form G address 
format, as for all geometric disk addresses, the first 
four digits of the record address correspond to the 
track number. The only difference between these as- 
signments is the last two characters, the hh identifier. 

Each time the user issues a get or put in his source 
program, the iocs increments the tttt section of the 
address. When end of physical unit is reached, the file 
is switched to the alternate unit, if one is assigned. 
(In the example, A2 and A5 are the alternate units 
for mw7 and mw9, respectively. ) 

Before this form of record addressing can be used 
to execute an object program: 

1. The cylinder must be formatted to the desired 
scheme; and 

2. During System Generation, the System Monitor 
must be informed of the addresses by use of macro- 
instructions GEN03, GEN04, GEN05, and GEN06 — diSCUSSed 
later in this manual. 

To use this form of record addressing in a source 
program, the user must write the proper dtf and da 
statements in his source program. 

Note: Data files can also be placed on ibm 1311 
Disk Storage. The organization of the 1311 disk is 
discussed in Support of IBM 1311 Disk Storage Drives 
Under the Operating System. 



System Generation Considerations 23 



Relocatable Libraries 

Control cards needed to build and maintain relocat- 
able libraries for a tape-oriented system are discussed 
first; control cards needed to build and maintain re- 
locatable libraries for a disk-oriented system are then 
discussed. 

Building a New Library as Part of a Tape SOF 

During a System Generation run, the user may build 
additional relocatable libraries on the sof. 

For example, a new relocatable library can be 
added with the following cards subsequent to the 
exeq sgi card: 

16 21 

ADD R,newname 
(Follow ADD card with the relocatable subpro- 
grams of the library, newname. These cards must 
appear prior to the first END card. ) 

In addition, the user must specify the insertion 
point of the new library. (All relocatable libraries and 



the create packets of the Create Library require that 
the insertion point be specified. ) The insertion point 
is specified by a phase card during an sgf run. During 
a maintenance run, the insertion point is specified by 
an incld card. 

Figure 7 shows the creation of an additional library 
on the sgf; Figure 8 shows the addition of a library to 
the sof; and Figure 9 shows the maintenance of an ad- 
ditional library on the sof. Control cards related to 
creation or maintenance of the additional library are 
indicated by ***. 

Note: In Figure 7, creattransit card(s) may be 
added to give additional copy(ies) of Transitional 
Monitor. 

Building a Library External to a Tape SOF 

Instructions for creating and maintaining external 
relocatable tape libraries that are not a part of the 
sof are given below. During this type of run, no other 
functions of System Generation may be used. 



6 16 21 

MON»» DATE VRDAT 

MONSS JOB ILLUSTRATE LIBRARY CREATION, GENERATE RUN 

MON*S ASGN MJB.A1 

MQNSS ASGN MR0.A3 

MONSS ASGN MW2.A5 

MONSS ASGN MG0.B2 

MONSS ASGN MWI.B4 

MONS* ASGN MW3.BS 

MONSS MODE GO.SG 

MONSS EXEQ AUTOCOOER...NOFLG.NOPCH 

HEAORGENERATE SGF 

GEN01PI ,Rl ,X1 

GEN02/MDM/ , 1 , AO , Al , A2 , A3 . A4 . AS. A6 , A7 . A8 , A9 , 

GEN02/MDM/.2,B0.8l.B2.B3.B4,85.B6.B7,B8.B9, 

GEN081 700090 119. .55, 5.099. A0,R1.,,P1 .XI . ..B6.SNAP 

GEN0910 

GEN1010.A4.B4.A5.B5. A6 

GENU 

DEVOFI .729, 1402. 1403 

OEV0F2.729 

IOKOFI410...... , ..7000 

END 

EXEQ SGI 7 

LOCATC.CREATLIB 

INSERC 

LOCATR.IBMLIBR 

INSERR 

ADD R. NEWNAME 
TABLE MODULES •«« 

LOC ATM. AUTOCODER 

INSERM 

END 

CREATTMONITOR 

CREATRESTART 

CREATSVSGEN3 

CREATTAUTOCODE 

CREATTLINKLOAD 

PHASE IBMLIBR R 

PHASENEWNAME R 

CREATTSYSGEN1 

PHASECREATLIB r 

CREATTSYSGEN2 

CREATUTILITIES 

CREATTMACROPRT 

CREATTFORTRAN 

CREATTCOBOL 

END 

EXEQ LINKLOAD 

INPUTMW2 

EXEQ SG2 17 

END 



MONSS 



• •• 

••» RELOCA 



MONSS 



MONSS 
MONSS 



Figure 7. Control Cards for the Addition of a User's Relocatable Library to the sgf of a Tape-Oriented System 
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MONtt 
MON$$ 
MONtt 
MONtt 
MONti 
MONtt 
MONtt 
MONit 



• «» 

••• RELOCAT 
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MONtt 
MONtt 



MONtt 
MONti 



DATE YYYDD 

JOB ILLUSTRATE ACOING LIBRARY DURING PROC 
ASGN MW1.B4 
ASGN HW2.AS 
ASGN NJB.A1 
ASGN MRO.A3 
MODE SG 

EXEO SGI 7 

LOCATCtCREATLIB 
1NSERC 

LOCATR.IBHLIBR 
INSERR 

ADD R.NEWNAME 
ABLE MODULES 

LOCATM, AUTOCODER 

1NSERM 

END 

INCLOIBBOOT 

INCLD1BRESMON 

tNCLDRESTART 

INCLD1BTRANS1T 

INCL0SG3 
NCLDAUTOCODER 
NCLDIBTRANSIT 
NCLDIBMLIBR 
END 

EXEQ LINKLOAD 
PHASENEWNAME 
EXEQ SGI 

NCLDSGi 

NCLOCREATL1B 

NCLOSG2 

NCLDUTILITIES 

NCLDMACROPRT 

NCLDIBTRANS1T 

NCLDFORTRAN 

NCLOCOBOL 

NCLOIBTRANSIT 
END 

EXEQ SG2 
END 



Figure 8. Control Cards for Addition of a User's Relocatable Library to an sof of a Tape-Oriented System 



MONtt 
MONit 
MONti 
MONti 
MONit 
MONti 



Building an Independent Tape Library 

Control cards used to build an independent library are- 
shown below. (Assignment symbols used in this ex- 
ample are those appearing under "IBM Master File — 
Tape-Oriented System.") 

' - \k* &bV' BRARV building an indep 

ASGN MW2.A5 ENDENT TAPE LIB 

ASGN MR0.A3 

ASGN MJB.A1 

EXEQ SGI 

(RELOCATABLE'suBPROGRAMS TO BE INCLUDED IN 
RELOCATABLE LIBRARY! 

MONtt EXEQ SG2 S" 

MONti END 

"LIBNAME can be any name not exceeding ten characters. 
""Column 57 contains any character. 

Execution of sgi and SG2 produces a library file on 
symbolic unit mwi and a list of library subprogram 
names on the spr. (Date of compilation of each sub- 
program is also shown. ) 

This library file can be used by: 

1. Assigning symbolic unit lib to an assignment 
symbol other than the one assigned to the sof; and 

2. Referencing the library name as the fourth pa- 
rameter of the execute card for linkload. 

Every reference to a library in the operation of 
Linkage Loader accesses the library file. The library 
name must be the same as the name specified in the 
exeq linkload card (fourth parameter). 

Maintaining a Tape Library 

Control cards used to update a library are shown in 
the following example. 



MONtt JOB MAINTAIN LIBRARY 

MONtt ASGN MWI ,84 

MONtt ASGN MR0.A3 

MONtt ASGN MJB.A1 

" 0Ntl al1?bt S a-pe 



•MODULEC REPLCR 

(New relocatable subprogram, MODULEC, that 
replaces old MODULEC) 



•MODULEN 
MOOULEX 



DELETR 
INSERR 



(Relocatable subprogram, MODULEX) 



MONtt 
MONtt 



END 

EXEQ SG2 
END 



• •X 



"Subprograms must be referenced in the sequence in which 
they appear on the tape library. 
** Column 57 contains any character. 

The execution of sgi provides an updated library 
(lib) on mwi, and the execution of SG2 provides a list 
of library subprogram names on the spr. modulec is 
replaced with a new modulec; modulen is deleted; 
and modulex is inserted at the end of the library. 
Refer to "System Generation Control Cards" for the 
method of inserting a subprogram between existing 
subprograms of the library. 

Additional information will be found under "System 
Maintenance." 

Disk Relocatable Library Considerations 

All relocatable libraries are "external" libraries in the 
disk system. During the loading of a disk system 
(tape-to-disk), the relocatable library on the input 
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MONSS 


DATE YYDOD 


MONSS 


JOB ILLUSTRATE LIBRARY MAINTENANCE. INCLO RUN 


MONSS 


AS6N MW1.B4 


MONSS 


ASGN MW2.A5 


MONSS 


A5GN MJB.A1 


MONSS 


ASGN MR0.A3 


MONSS 


EXEQ SGI 7 




LOCATCCREATLIB 




INSERC 




L0CATR.IBMLI6R 




INSERR 


»»» 


LOCATR.NEWNAME 


*** INSER. 


REPLC, AND DELET CARDS FOLLOWED BY RELOCATABLE MODULES *** 




LOCATM. AUTOCODER 




INSERM 




END 




INCLDIBBOOT 




INCLDIBRESMON 




INCLDRESTART 




INCLDIBTRANSIT 




INCLDSG3 




INCLDAUTOCO»ER 




INCLDIBTRANSIT 




INCLDLINKLOAD 




INCLDIBTRANSIT 




INCLDIBMLIBR 


••• 


INCLDNEWNAME 




INCLDSG1 




INCLDCREATLIB 




INCLDSG2 




INCLDUTILITIES 




INCLDMACROPRT 




INCLDIBTRANSIT 




INCLDFORTRAN 




INCLDCOBOL 




INCLDIBTRANSIT 




END 


MONSS 


EXEQ SG2 7 


MONSS 


END 



Figure 9. Control Cards for Maintenance of a User's Relocatable Library of the sof of a Tape-Oriented System 



tape must be loaded into the disk area to be assigned 
as lib (instead of the sof). 

During a standard 'System Generation run, the one 
library (lib) can be copied onto the tape that con- 
tains the new system. If complete regeneration capa- 
bilities are to be preserved, this library must contain 
all library subprograms supplied on the Master file. 

Instructions for creating and maintaining a disk 
library are given below. 

Building a Disk Library 

Control cards used to build a new disk library are 
shown below. (Assignment symbols used in this exam- 
ple are those appearing under "IBM Master File — 
Disk-Oriented System.") 



6 16 21 

MONSS JOB BUILD D LIBRARY 
MONSS ASGN MW2.A1* 
MONSS EXEQ SG2 

ADD R,LIBNAME«»« 

( Relocatable subprograms 
Relocatable Library) 

ENO 
END 



• •X 



to be included in 



MONSS 

*A1 must be a tape unit. 
"Column 57 contains any character. 
""LIBNAME can be any name not exceeding ten characters. 

The new library is produced on tape unit mw2. To 
use this new library, it must be loaded onto the disk 
in the area assigned as lib. The program dsklibldr is 



used to perform this function, as described under 
"Disk Load Programs." 

Maintaining a Disk Library 

The four general situations for which a disk relocat- 
able library can be maintained are: 

1. The library on disk (lib) to be updated and 
written onto tape unit MW2; mw2 to contain only the 
library material. 

2. The library-only tape (created by a previous run) 
to be updated and written onto tape unit mws; mws 
to contain only the library material. 

3. The library on disk (lib) to be updated and writ- 
ten onto tape unit mw2 following the disk system sof 
or SGF. 

4. The library-only tape ( created by a previous run ) 
to be updated and written onto tape unit MW2 follow- 
ing the disk system sof or sfg. 

All maintenance of relocatable libraries produces 
tape output. This tape must be loaded onto the disk 
in the area assigned to lib to make the library avail- 
able to dependent programs. (Refer to "Disk Load 
Programs.") 

Figures 10A and 10B, respectively, illustrate the con- 
trol cards required to provide maintenance for the first 
two situations listed above. 

The third situation is illustrated in Figure 5. 
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For the fourth situation listed above, two changes 
must be made in the control cards shown in Figure 5: 
the locat card is replaced with an altlb tape card; 
and an asgn card is added, immediately preceding the 
exeq SG2 card, to assign lib to a tape unit. 

Note: For further information, see "System Main- 
tenance." 



6 16 21 

MONSS JOB NO.l. UPDATE LIB ONLY. DISK TO TAPE 

MONSS ASGN LIB.E* 

MONSS ASGN MW2.A1 TO A TAPE UNIT 

(NOTE PUNCH IN COL. 57 OF NEXT CARD) 
MONSS EXEQ SG2 X 

LOCATR.LIBNAME 
»»*INSER. REPLC. DELET CAROS AND RELOCATABLE MODULES*** 

END 
MONSS ENO 



Figure 10A. Control Cards to Update a Disk Library onto a 
Library-Only Tape 



MONSS JOB NO. 2. UPDATE LIB ONLYi TAPE TO TAPE 

MONSS AS6N LIB.B1 TO A TAPE UNIT 

MONSS ASGN MW2.A1 

(NOTE PUNCH IN COL. 57 OF NEXT CARD) 
MONSS EXEQ SG2 X 

ALTLBTAPE 
«**INSER. REPLCt DELET CARDS AND RELOCATABLE MODULES*** 

END 
MONSS END 

Figure 10B. Control Cards to Update a Library-Only Tape 
onto a New Library-Only Tape 



Sort Definition Program 

The Sort Definition program (sortdefine for tape, or 
dsrtdefine for disk) must be an absolute program on 
the sof or sgf if sort programs are to be incorporated 
onto an sof. The Sort Definition program is incorpo- 
rated onto an sgf automatically when the creat cards 
tsystem or dsystem are used to create the sgf. An al- 
ternative to this is the use of the creat card tsrtdefin 
(for tape), or the creat card dsrtdefin (for disk). De- 
tails appear under "Contents of the Libraries," and 
"Creation Charts." 

The absolute Sort Definition program is copied from 
an sgf to an sof by inserting the card incld sortdefine 
(or dsrtdefine) into the deck, which is illustrated in 
the section "Building an SOF" under "Basic Concepts." 
The incld card copies the Sort Definition program 
during the maintenance of an sof. 

Sort programs are incorporated onto an sof using an 
operation similar to that discussed under "General 
Maintenance Considerations" of "Basic Concepts— 
Tape-Oriented System," or "Basic Concepts-Disk- 
Oriented System." The control cards for execution of 
the Sort Definition program are explained in the pub- 
lications Generalized Tape Sorting Program and Gen- 
eralized Sorting Program Using IBM 1301/2302 Disk 
Storage. Any set of sort definition control cards de- 



scribed in the above publications is acceptable, in- 
cluding those required for a modified sort program. 
Figure 11 illustrates the incorporation of a single 
tape sort program onto an sof. To incorporate a single 
disk sort program, the user must change references to 
sortdefine to refer to dsrtdefine. 



MONSS 


DATE YYDDD 


MONSS 


JOB ILLUSTRATE SORTDEFINE 


MONSS 


ASGN MJB.A1 


MONSS 


ASGN MR0.A3 


MONSS 


ASGN MW2.A5 


MONSS 


ASGN MW1.B4 


MONSS 


ASGN MW3.B5 


MONSS 


MODE SG 


MONSS 


EXEQ SGI 




LOCATC.CREATLIB 




INSERC 




LOCATR.IBMLIBR 




INSERR 




LOCATM. AUTOCODER 




INSERM 




END 




INCLDIBBOOT 




INCLDIBRESMON 




INCLDIBTRANSIT 




INCLDAUTOCODER 




INCLDSORTDEFINE 




INCLDLINKLOAD 




INCLDIBMLIBR 




END 


MONSS 


EXEQ SORTDEFINE 


SORTEXMPLEDSORTSORT. FIXED. MULTIPLE. UNMODIF 




DUNITMW1.MW2.MW3 


MONSS 


EXEQ LINKLOAD 




INPUTMW2 


MONSS 


EXEQ SGI 




INCLDSG1 




INCLDCREATLIB 




INCLDSG2 




END 


MONSS 


EXEQ SG2 


MONSS 


END 


Figure 


11. Control Cards to Incorporate a Sing 



onto an sof 

The File Organization System 

The File Organization System (fos) is a set of ibm 
1410/7010 Operating System programs designed to 
store and maintain data files in ibm 1301 or 2302 Disk 
Storage, fos permits object programs to address rec- 
ords in disk storage through record identifiers, without 
using disk addresses, or to retrieve data files in record 
sequence without the use of outside lists or "finder 
files." 

The File Organization System is created by the Sys- 
tem Definition program of the Master file. In both the 
tape-oriented and disk-oriented Master files, the Sys- 
tem Definition program and File Organization System 
control and operating modules (e.g., ibfosadd) are 
included in relocatable form in the Relocatable Li- 
brary. The System Definition program is also included 
in absolute form in the operating sections of the Mas- 
ter files. System Generation options provide a variety 
of ways in which the appropriate sof may be built 
from the Master file, and used. 
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Requirements for System Description Control Cards 

The File Organization System requires that specific 
parameters be included in the control cards defining 
the type of operating system desired by the user ( see 
"System Description Control Cards"). For purposes of 
this discussion, it is assumed that the appropriate Disk 
Definition (dskdf) control cards are part of the sg 
deck. The File Organization System imposes no re- 
quirements on the dskdf macro statement except that 
it must be present. Specific fos requirements for the 
System Description control cards are: 

1. Parameter 4 of the genos macro statement must 
be 20 because fos requires a 20-position console Input 
Area in Resident Monitor. 

2. Parameter 18 of the genos control card must be 
the address of the first track of the disk storage area 
reserved as File Directory and Index area for fos use 
( see "Monitor Definitions genos" ) . 

3. Parameter 7 of the iokdf macro statement must 
be present if any organized file contains Form 1 rec- 
ords. 

4. Parameter 8 must be present if any fos program 
is to use the Write Disk Check option. 

Relocation and Execution of the System 
Definition Program 

The major methods of relocating and/or executing the 
System Definition program are outlined below: 

If the Master file is used, or if the source sgf con- 
tains the System Definition program in absolute form, 
the definition program can be executed during System 
Generation to produce user-defined fos programs. Re- 
quired control cards for the execution of the System 
Definition program are: 

MON$$ EXEQ DEFINE 

I userlabel SYSDF parameters" 
These control cards, and the subsequent action of the 
Linkage Loader and SG2 programs, cause the defined 

I fos program, userlabel, to appear on the sof in abso- 
lute form. 

The iblookm module is required in the Relocatable 
Library for the creation of the File Organization Sys- 
tem. 

I If it is desired to copy the absolute-form System 
Definition program from one sof to another, or from an 
sgf to an sof, the control card incld define should be 
used. (The incld card, if present, must follow the 
exeq sgi card for a tape-oriented system, or the exeq 
SG2 card for a disk-oriented system. ) 

* For a description of these parameters see the publi- 
cation, "File Organization System for IBM 1301/2302 
Disk Storage." 



If an sof being produced is to contain the System 
Definition program, in absolute form, and the source 
file (Master file or sgf) contains the program in relo- 
catable form only, the sgi control card should be fol- 
lowed by a ckeat define card, or the Linkage Loader 
control cards: 

PHASE DEFINE 

CALL IBFOSYSDEF 
Subsequent execution of the Linkage Loader and SG2 
programs brings in the System Definition program 
from the Relocatable Library, relocates the program, 
and places it on the sof in absolute form. 

The fos control and operating modules in the Relo- 
catable Library include two forms of the Add func- 
tion module: ibfosadd and ibfosadd2. ibfosadd is used 
with ibm 1301 Disk Storage only; ibfosadd2 must be 
used with ibm 2302 Disk Storage and may also be used 
with 1301 Disk. During System Generation, either of 
these modules may be deleted from the sof by replac- 
ing the inser r card, which ordinarily follows the 
locat r,ibmlibr card, with the following card: 

IBFOSADDn DELET R 
where n is blank to delete ibfosadd or 2 to delete 
ibfosadd2. The Relocatable Library ( except the named 
module) will be copied. 

Building Monitors with Tele-processing 
Capabilities 

The Tele-processing Supervisor becomes a part of the 
Resident Monitor through System Generation. To per- 
mit inclusion of the Supervisor at the proper point in 
the Resident Monitor, special Create Library packets 
can be used. These packets aid in building a tape- or 
disk-oriented Monitor for either a standard configura- 
tion or a tp Only configuration. 

Ba'sically, there is a create packet that precedes the 
Supervisor call cards, and another create packet that 
follows them. The pairs of packets are: 

TMONTP1 These packets create a standard tape Monitor 

TMONTP2 with Tele-processing capabilities. 

DMONTP1 These packets create a standard disk Monitor 

DMONTP2 with Tele-processing capabilities. 

The rules governing the calling of the various mod- 
ules to make up a tp complex, as well as the names 
and functions of each module, appear in the publica- 
tion, Tele-processing Supervisor. 

Figure 12 is an example for building a standard tape 
Monitor for a Tele-processing system using the ibm 
1014. 

Figure 13 is an example for building a standard 
disk Monitor for a Tele-processing system with Pro- 
grammed Transmission Control (ptc). 
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6 

MONtt 
MONtt 
HONt$ 
MONSt 
MONtt 
MONtt 
MON$t 
MONtt 
MONti 
MONtt 



MONti 



MON$t 



MONti 
MONti 



12 21 
DATE YRDAY 

JOB GENERATE TP TAPE SYSTEM 
ASGN MR0.A3 
ASGN MJB.B3 
ASGN MG0.B2 
ASGN MW1.A4 
ASGN MW2.A5 
ASGN MW3.B4 
MODE GO.SG 

EXEQ AUTOCODER, , .NOFLG.NOPCH 
HEADRGENERATE TP TAPE SYSTEM 
GENOlPl.Rl.Xl 

GEN02/MDM/,1,A0,A1,A2,A3,A4,A5,A6,A7 
GEN02/M0M/,2.B0,B1,B2,B3,B4.B5,B6,B7 

GEN08 17009901 10, 4000, 55, 20, 099, A0.R1,,, PI, XI,,, B6, SNAP 
GEN0910 

GEN1010,A4,B4,A5,B5,A6 
GEN115 

DEVOF 1,729 ,1402, 1403,, TP 
DEVDF2.729 
I0KDF1410,, 
TPDIR30.10 
END 

EXEQ SGI 
LOCATR.IBMLIBR 
INSERR 

LOCATM, AUTOCODER 
INSERM 
END 

CREATTM0NTP1 
CALLNTPSTARTCH1 
CALLNTP1014CH10 
CALLNTPEN0CH1 
CALLNTPTAPELDRA 
CALLNTPSUPER 



CREATTM0NTP2 

PHASETPATLIBGEN 

CALL TPATLIBGEN 

CREATTLINKLOAD 

CREATTAUTOCODE 

CREATTSYSGEN1 

CREATTSYSGEN2 

PHASEIBML1BR 

END 

EXEQ LINKLOAD 

INPUTMW2 

EXEQ SG2 

END 



USER INSERTS THE EXECUTIVE HERE 



Figure 12. Control Cards for a Tape-Oriented Monitor for a Tele-processing System with ibm 1014 



Each example indicates where the user is to insert 
his Tele-processing Executive. This can be done in one 
of three ways: 

1. The user can insert the relocatable object deck 
at the place indicated in the examples. 

2. The user may have included the Executive in the 
relocatable library and can call it with a calln card. 

3. The user may insert his Autocoder source deck 
after the tpdir macro and have the object deck placed 
on the Go file. This module can then be called with a 
calln card at the appropriate time. 

Random-Processing Scheduler 

One of the relocatable subprograms (ibbandomi) re- 
quired by the Random-Processing Scheduler must be 
compiled by each user. The following steps indicate 
the method of generating the subprogram and incor- 
porating it into ibmlibb: 

1. The user includes the genem macro ( see "System 
Description Control Cards") in his deck when gener- 
ating the sgf. This produces ibrandomi, the relocat- 
able subprogram, written on the Go file. 

2. The user then requests that ibrandomi be in- 
corporated into the Relocatable Library by plac- 
ing the following card into the deck following the 
locatr,ibmltbb card: 

6 16 21 

IBRANDOMI INSER R.IBRANDOM2 



If no other maintenance is to be performed on the 
library, this is the only card required. Refer to Class 
rv control cards (under "System Generation Control 
Cards") if other maintenance is to be done. 

Macro Print and Punch Program 

The Macro Print and Punch program can write infor- 
mation selected from the Macro Library onto the 
Standard Print Unit and onto either the Standard 
Punch Unit or any mrx or mwx symbolic unit previ- 
ously assigned to a tape unit. The output on the spr 
is printed output, and the output on the spu or tape 
unit is punched output of macroprt. The printed out- 
put can consist of any or all of the following items: 

1. The identifier (get, genoi, etc.) of each macro 
routine. 

2. The contents of a macro routine. 

3. The page and line number of every reference to 
L characters in model statements. L characters are 
the one-character labels appearing in column 6 of the 
Library Coding Form. This information is referred 
to as "cross-reference" information. 

The punched output consists of 80-character rec- 
ords in standard Macro Library format (see the pub- 
lication Autocoder, Form C28-0326). The following 
sysgen control card will appear on the punched out- 
put file before the first statement of each macro 
punched: 
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»•» INSERT 
MON$* 
MON$» 
HON$$ 
HONtt 
MQN$$ 
MON$$ 
MON$$ 
MON$$ 
HON$$ 
MON$* 



MON$$ 
MONtt 



16 21 
BOOTSTRAP CARD « 

DATE YRDAY 

JOB GENERATE DISK SY 

ASGN LIB.E2 

ASGN MJB.E3 

ASGN MG0.E4 

ASGN MW1.E5 

ASGN MW2.E6 

ASGN MW3.E7 

MODE GO.SG 

EXEO AUTOCODER,,, NOFL 

HEADRGENERATE DISK SO 

GEN01P1,R1,X1 

GEN02,l,AO,Al 

GCN02,2,BO,B1 

GEN03E 1,00000006, 2 199 
E4, 00300000, 3399 
£7,00420000,4599 

GEN04G1, 00000000, 2 199 
G4, 00300000, 3399 
G7, 00420000. 4599 

GEN08 1790990 110,4000, 

GEN0910 

GEN1010,E4,G1,E6,E5,G 

GEN115 

0EVDF1, 729, 1402, 1403, 

0EVDF2.729 

DSKDF1.00 

DSKDF2.00 

IOKDF1410,,,,,,,8 

TPDIR30.10 

END 

ASGN MW2.A2 

EXEQ SGI 

CREATDM0NTP1 

CALLNTPPTCCH1 

CALLNTPSUPER 

CALLNTPDISKLDRA 



MONH 

MON$$ 



MONIS 



STEM HITH TP 



G.NOPCH 
F WITH TP 



,E2, 00220000 
,E5, 00340000 
,E8, 00460000 
G2, 00220000 
G5, 00340000 
,G8, 00460000 
55, 20, 099, El 



,PTC 



,2 599, E3, 00260000, 2999, 
,3799, E6, 00380000, 4 199, 
, 4999, E9, 00500000, 5399 
,2 599, G3, 00260000, 2999, 
, 3799, G6, 00380000,4199, 
, 4999, G9, 00500000, 5399 
,R1,,,P1,X1,,,,SNAP 



CREAT0M0NTP2 

PHASETPADLIBGEN 

CALL TPADLIBGEN 

CREATDLINKLOAD 

CREATDAUTOCODE 

CREATDSYSGEN1 

CREAT0SYSGEN2 

END 

EXEO LINKLOAD 

INPUTMW2 

EXEQ SG2 

LOCATR.IBMUBR 

1NSERR 

END 

ENO 



USER INSERTS THE EXECUTIVE HERE 



Figure 13. Control Cards for a Disk-Oriented Monitor with Programmed Transmission Control tp Capability 



6 16 21 

NAME1 REPLCM 

where namei is the macro name. In addition, every 
macro statement will have the n» field punched in 
positions 75 through 80 as follows: 

75 80 

bNAMEl 

where namei is the macro name. The last record of 
the punched output file is the following sysgen con- 
trol card: 

16 
END 

The Create Library packets needed to build this 
program for a tape- or disk-oriented system appear 
under "Creation Charts." 

System Requirements 

macroprt is not run during System Generation; it 
requires a standard job run. The running of the pro- 
gram requires that macroprt must have been placed 
on the sof during System Generation. 

EXEQ Card 

The exeq card is a standard Monitor control card and 
is used to call in the macroprt program. It also serves 
to select the printing or punching options (or both). 



The printing of macros is always assumed; the follow- 
ing exeq card will cause printing only: 

6 16 21 

MON$$ EXEQ MACROPRT 

The following exeq card will cause printing and 
punching: 

6 16 21 

MON$$ EXEQ MACROPRT , , , xyz 

where xyz is sptj, mrx, or mwx and indicates where to 
put the macro statements. 

To inhibit printing while punching, the following 
exeq card is used: 

6 16 21 

MON$$ EXEQ MACROPRT, , , xyz, NOPRT 

PRINT Card 

Only the print control card, other than the exeq card, 
is needed to run macroprt. The print card may be 
repeated and has the following format: 



EXPLANATION 

Not used. 

Make entry if the program is to list the 
name of each macro routine; otherwise, 
entry is blank. (This entry should ap- 
pear only on the first card of the control 
package. ) This parameter applies only 
to printed output. 



CARD 




COLUMN 


CONTENTS 


1-5 


blank 


6-11 


HEADER 



30 



CARD 
COLUMN CONTENTS 

12-15 blank 



EXPLANATION 



CARD 
COLUMN 



Not used. 



CONTENTS 

name6 



EXPLANATION 



16-20 PRINT Identifies this card type. 

21-72 The information in this field defines 

which macro routines are to be com- 
pletely printed or punched, and whether 
or not cross referencing is to be made. 
The field may be left blank only if the 
name of each macro routine is to be 
printed. The first parameter to be entered 
is left-justified in column 21. If more 
than one parameter is placed in this 
field, the parameters must be separated 
by commas. No blanks may appear in or 
between parameters. 

CROSS CROSS, if entered, must be the first 
parameter. It directs the program to cross 
reference L characters in model state- 
ments on the printed output only. 

ALL ALL must be either the first or second 

(if CROSS is used) parameter if all 
macro routines in the Macro Library are 
to be printed or punched. 
Note: When this entry is used, the 
program will assume that there are no 
other entries in the operand. If the ALL 
entry is not used, macro routines for 
which information is desired must be 
specified in the sequence in which they 
reside on the library. Refer to "Macro 
Library Contents" for the sequence of 
the Macro Library. Examples of the 
specification of the macro routines to be 
included are given below. 

START All macro routines from the beginning of 
name8 the library up to and including name8 
will be printed or punched. 

name! Only name! will be printed or punched. 
name4 All macro routines starting with name4 



and up to and including name6 will be 
printed or punched. (name6 must phys- 
ically follow name4 in the library. ) 
END All macro routines starting with name3 

name3 and continuing through the end of the 
library will be printed or punched. 

Note: Because of the above parameter definitions, 
no macro instruction can have the names cross, all, 

START, Or END. 

Example 1: Print the name of each macro routine. 

6 16 

HEADER PRINT 

Example 2: Print or punch the name and contents 
of each macro routine. 

6 16 21 

HEADER PRINT ALL 

Example 3: Print or punch the name, contents, and 
cross reference of each macro routine. 

6 16 21 

HEADER PRINT CROSS, ALL 

Example 4: Print or punch the contents of selected 
macro routines, from the beginning of the library 
through macra; skipping to and printing or punching 
macrc; skipping to macrf; printing or punching from 
macrf to macrh; skipping to macrn; and printing or 
punching from macrn to the end of the library, cross 
referencing each macro routine selected on the printed 
output. 

16 21 

PRINT CROSS, START-MACRA, MACRC, 
MACRF-MACRH, MACRN-END 
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Data Flow During System Generation Runs 



This section is optional (but recommended) back- 
ground reading that provides an over-all correlation 
between the files operated upon and the data flow re- 
quired to generate a system. 

This section graphically depicts the tape layout for 
the Master file, a typical sgf, and a typical sof. Most 
of the section summarizes over-all data flow for the 
System Generation of a- tape- or disk-oriented system. 



Tape Layout 

Figure 14(A) depicts the Master file. It shows the 
operating section and the three libraries. 

Figure 14(B) is a typical sgf layout. This reel of 
tape serves as the "Master file" for a particular instal- 
lation. The operating section of the sgf consists of a 
System Monitor tailored to the specific machine envi- 



ronment of the installation, and those programs re- 
quired for System Generation. 

The three types of libraries on the Master file may 
be transferred to the sgf. During this process the user 
may add to, delete from, and modify the libraries. 

Figure 14(C) is a typical sof layout. The System 
Monitor of the sof may be copied from the sgf or gen- 
erated for specific features. The rest of the sof con- 
sists of programs in absolute format and any library 
subprograms that the user has transferred from the 
sgf or has constructed. 

Over-all Data Flow — Tape System 

Figure 15 shows over-all potential data flow for the 
System Generation of a tape-oriented system. All of the 
capabilities are not necessarily used in a typical Sys- 
tem Generation. The source file shown in the figure 
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* Refer to "Creation Charts . " 
** Refer to "Relocatable Library Contents. 
*** DIR] is the directory of phase names. 
DIR3 is the Macro Library directory. 



A Typical SOF Copied from the SGF, with insertion of 
Multiple Transitional Monitors for Tape Systems Only 



Figure 14. The System Files 
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Macro Instructions and 



Source Language Statements 



Macro Routines 




Step 1 
Autocoder 



Subprograms 



Control Cards and 



New Library Subprograms 
Library Subprograms 



LOCAT 
(Master, 

SGF, or ) Source File 
SOF) 

Programs 



Step 2 
SGI 



Subprograms 




Libraries INSER, REPLC 



Library Header Records 
Control Cards 



Step 3 
SGI 



Program and Library 



Header Records 
Programs 



Library Header Records 



Create Packets 




CREAT Cards, LLCC, 
and Subprograms 



Step 4 
SGI 



LLCC and Subprograms 



Control Cards 



Step 5 
Sort Definition 



LLCC 



LLCC and 



Subprograms 
Relocatable Subprograms 



Step 6 
Linkage Loader 



t LLCC and Subprograms 




Library and Program Header Records, and Programs 



Program Header Records, and Records 



^Subprograms From MGO 




Directories and Transitional Monitor 



Step 7 
SG2 



2nd Pass; Programs 



1st Pass; Header Records and Libraries 




Output File (SGF or SOF) 



Printout of File 



^ Programs, Directories, and Libraries 



NOTE: 

LLCC = Linkage Loader Control Cards 




♦H MW2 



Figure 15. Steps in the Generation of a Tape System 
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may be a Master file, sgf, or sof. Each major step in 
the figure is explained below. 



PROGRAM 

BEING 
EXECUTED 



ACTION PERFORMED 



PROGRAM 
TEP BEING 

EXECUTED 

1 AUTOCODER Autocoder produces relocatable sub- 

programs on the Go file. 

2 SGI SGI copies and/or updates libraries 

from the source file. New libraries also 
may be created. Input is from the SIU 
or, in the case of relocatable libraries, 
may also come from the Go file. Out- 
put consists of libraries on MW1. 

3 SGI SGI copies existing programs from the 

source file onto the Job file. A header 
for each program copied is written on 
MW1. If any library is to be placed 
onto the output tape, only a header 
indicating the location for the library 
is written on the Job file and MW1. 

4 SGI SGI transfers Linkage Loader control 

cards from the Create Library onto 
MW2. SGI also places on MW2 any 
Linkage Loader control cards or sub- 
programs encountered in the SIU. 

5 SORTDEFINE This program generates Linkage 

Loader control cards, from its input 
parameters, onto MW2. 

6 LINKLOAD Linkage Loader converts relocatable 

subprograms into absolute programs 
and places them on the Job file. Con- 
trol card input may come from the 
SIU or MW2. Relocatable input may 
come from a relocatable library on the 
source file, the Go file, the SIU, and/or 
MW2. Linkage Loader also produces 
a header on MW1 for each phase it 
produces on the Job file. 
Note: Step 2, if used, must be performed only once 
during a System Generation run. Steps 3, 4, 5, and 6 
may be performed any number of times, and in any se- 
quence desired. The order of the new SGF or SOF (see 
step 7) is determined solely by the order of the elements 
on the Job file. 
7 SG2 SG2 must be the last program exe- 

cuted in any System Generation run. 
It performs two major functions. It 
first scans MW1. MW1 contains all 
libraries and a header for every phase 
of each program on the Job file. From 
this information, it produces two di- 
rectories and writes them on MRO. If 
the Standard Print Unit is available in 
the system, this step also lists the 
names and order of the subprograms 
of each library, and the names and 
order of each program of the SGF or 
the new SOF. The second function is 
to copy the Job file to MW2, which 
contains the SGF or the new SOF. As 



ACTION PERFORMED 

it copies, it inserts directories from 
MRO and libraries from MW1 when 
there are requesting headers. It also 
provides blocked, absolute-format rec- 
ords. 



Over-all Data Flow — Disk System 

Figure 16 shows over-all potential data flow for the 
System Generation of a disk-oriented system. All of the 
capabilities are not necessarily used in a typical Sys- 
tem Generation. The source file shown in the figure 
may be a Master file, sgf, or sof that has been loaded 
onto disk storage. Each major step in the figure is 
explained below. 



ACTION PERFORMED 



PROGRAM 
STEP BEING 

EXECUTED 

1 AUTOCODER Autocoder produces relocatable sub- 

programs on the Go file. 

Note: MW2 must be assigned to an 

area on the disk. 

2 SGI SGI transfers Linkage Loader control 

cards from the Create Library onto 
MW2. SGI also places on MW2 any 
Linkage Loader control cards or sub- 
programs encountered in the SIU. 
Note: MW2 must be a tape file dur- 
ing this and remaining operations. 

3 DSRTDEFINE This program generates Linkage 

Loader control cards, from its input 
parameters, onto MW2. 

Note: Steps 2 and 3 may be performed any number of 

times and in any sequence desired. 

4 LINKLOAD The Linkage Loader converts relocat- 

able subprograms into absolute pro- 
grams and places them on the Job 
file. Control card input may come 
from the SIU or MW2. Relocatable 
input may come from a relocatable 
library (LIB), the Go file, the SIU, 
and/or MW2. 

5 SG2 SG2 copies existing programs from the 

source file and the Job file onto the 
new output tape. 

6 SG2 SG2 copies and/or updates libraries. 

New libraries may also be created. 
Input is from the SIU or, in the case 
of relocatable libraries, may also come 
from the Go file. If the Standard Print 
Unit is available in the system, this 
step also lists the names and order of 
the subprograms of each library and 
the names and order of each program 
of the new SGF or the new SOF. 
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Master, 

SGF, or 

SOF on | Source Fll, 

Disk 




NOTES: *Must be a tape file 

LLCC = Linkage Loader Control Cards 

Figure 16. Steps in the Generation of a Disk System 
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System Description Control Cards 



This section contains the control cards that define the 
type of system desired by the user. The cards are 
source statements to the Autocoder processor. Auto- 
coder, through its macro-instruction facilities, uses the 
statements to select the modules required to create 
the desired Monitor and Resident iocs. 

The following Autocoder rules apply to the format 
of these macro statements: 

1. The macro name is written in columns 16-20 
(left- justified). 

2. The parameters (operands) are written begin- 
ning in column 21. 

3. The parameters are separated by commas. 

4. Blanks are not permissible within a parameter. 

5. Omitted parameters must be indicated by writ- 
ing the comma that would have followed the param- 
eter. (This rule does not apply if the omitted pa- 
rameter would have been the last on the card.) 

The macro statements should be sequenced by the 
user in the order in which they are described in this 
section. The genii macro is required whether or not 
Tele-processing capabilities are desired with the sys- 
tem. 

SPOOL Definitions (SPLDF) 

The spldf macro statement is used to specify the in- 
clusion of routines in the iocs to handle the spool 
(Simultaneous Peripheral Operation On Line) feature. 
This macro statement must be the first macro state- 
ment in the generation deck. A separate spldf macro 
statement must be made for each channel for which 
spool operations are desired. If no spldf macro state- 
ment is included, spool capabilities will not be avail- 
able. 

Note: General information on the spool feature is 
contained in the publication System Monitor, Form 
C28-0319. 



PARAM- 
ETER 
3 



CON- 
TENTS 

nnnnn 



PARAM- 
ETER 
1 



CON- 
TENTS 

lor2 



CRD 
ALL 



EXPLANATION 

Channel number to which the Unit 

Record device(s) used for SPOOL are 

attached. 

SPOOL operations will use only IBM 

1402 Card Read Punch. 

SPOOL operations will use IBM 1402 

Card Read Punch and IBM 1403 

Printer. 



I/O 



blank 



EXPLANATION 

Size of reserved area in Resident Mon- 
itor for user-written editing routine. 
The user-written editing routine re- 
quests input/output operations. (In- 
clusion of this parameter causes gen- 
eration of the Extension of IOCS.) 
The user-written editing routine re- 
quests no input/output operations. 

Three types of spool operations are available. The 
type selected determines which parameters of the 
spldf macro statement are to be used. The three types 

are: 

Type I: This type of spool implements normal op- 
eration with no blocking, deblocking, or editing of 
records. Parameters 1 and 2 of the spldf macro state- 
ment must be used; parameters 3 and 4 cannot be 
used. The statement below could be used to specify 
a Type I spool operation: 

16 21 

SPLDF l.CRD 

This statement specifies that spool operations on 
channel 1 will use only the ibm 1402 Card Read 
Punch for unit record equipment. 

Type II: This type of spool permits operations that 
include user-written editing routines (for blocking, 
deblocking, etc.); these user-written routines cannot 
request input/output operations. Parameters 1, 2, and 
3 of the spldf macro statement must be used; param- 
eter 4 cannot be used. The statement below could be 
used to specify a Type II spool operation: 

16 21 

SPLDF 2, ALL, 05678 

The statement specifies that spool operations on chan- 
nel 2 will use the ibm 1402 Card Read Punch and the 
ibm 1403 printer; a user-written editing routine (not 
to exceed 5,678 core locations) may be used. 

Type III This type of spool permits including user- 
written editing routines (for blocking, deblocking, 
etc.). The user-written editing routines can request 
input/output operations. All parameters of the spldf 
macro statement must be used; no parameter may be 
omitted. The following statement could be used to 
specify a Type III spool operation: 

16 21 

SPLDF 1, CRD, 08000, I/O 
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The statement specifies that spool operations on chan- 
nel 1 will use only the ibm 1402 Card Read Punch; a 
user-written editing routine (not to exceed 8,000 core 
locations in size) may be used; the editing routine 
can request input/output operations. 

Note: The Extension of iocs must be generated in 
the Resident iocs if a user-written editing routine is 
to request input/output operations. Use of the fourth 
(i/o) parameter of the spldf macro statement causes 
generation of this extension. The Extension of iocs is 
also generated for any system including Tele-process- 
ing programs. Thus, if the user intends to generate a 
Tele-processing system and has specified Type II spool 
operation, he can request input/output operations in 
his user-written editing routines. 

For Types II and III spool, the Autocoder source 
program for the editing routine can be assembled 
after the generation macro statements by including an 
exeq autocoder card (with columns 6-15 blank) and 
the source deck comprising the user-written editing 
routine after the end card for the macro statements. 
The relocatable user-written editing routine will be 
placed onto the Go file for subsequent access by the 
Linkage Loader. In calling the routine, the user must 
include a prtct 00000 card immediately following the 
first phase card for the routine, and a prtct card 
(with blank operand field) after the last end card 
for the routine. The control cards needed to generate 
a system including Type II and/or Type III spool 
are shown in Figure 17. (See "Use of Linkage 
Loader" in the publication IBM 1410/7010 Operating 
System; System Monitor, Form C28-0319. ) 

To include a user-written editing routine that is in 
relocatable form in the Library, the additional exeq 
autocoder card and the edit routine source deck are 
omitted. 

If the edit routine is to be made available on the 
siu in relocatable form, the above procedure must be 
followed. In addition, the calln card is removed 
and replaced with the relocatable module. 



Physical Unit Definitions 

Unit-Record Devices (GEN01) 

The genoi macro statement is used to declare the unit- 
record devices available to the system and to give each 
of them an assignment symbol. An assignment symbol 
(ss) can be any two alphameric characters unique 
(within the system) to the device it is identifying. 



MONSS 
MONSS 
MONSS 
MONSS 
MONSS 
MONSS 
MONSS 
MONSS 
MONSS 
MONSS 



MONSS 
MONSS 



16 21 
DATE VROAY 

as!n S«kb* TE T * PE or,ented sgf including SPOOL TYPE 3 

ASGN MW2^A5 

ASGN MW3.B5 

ASGN MJB.A1 

ASGN MHO. A3 

ASGN MG0.B2 

MOOE GO.SG 

EXEQ AUTOCODER, . .NOFLG.NOPCH 

HEAORGENERATE SGF 

SPLDF1 .ALL. 07000, I/O 

GEN01P1 .R1.X1 

G JN°2'MDM/.l.A0.Al.A2.A3.A4,A5.A6.A7.Aa.A9 
gInoI'o 00090U9 " S5>S ' 09 9'*°' R '-.Pi.x;...B6.SNAP 

GEN1010,A4,B4.A5,B5.A6 

GEN! 1 

DEVDF1, 729. 1402. 1403 - 

DEVDF2.7330 

IOKDFI410.,A,4.5....,,70000 

EXEQ AUTOCODER 

TITLEUSERPROG 
USER PROGRAM SYMBOLIC CARDS » 

END 

EXEQ SGI -• 

LOCATC.CREATLIB 

INSERC 

LOCATR.IBMLIBR 

I NSERH 

LOCATM, AUTOCODER 

INSERM 

END 

CREATTSYSTEM 

PHASEUSEREDIT 

CONGO 

PRTCTOOOOO 

CALLNUSERPROG 

PRTCT 

END 

EXEQ LINKLOAD 

INPUTMH2 

EXEQ SG2 



END 



L7 



1 

2 
3 

4 
5 
6 



Figure 17. Control Cards for a Tape-Oriented sgf Including 
Type III spool 



PARAM- CON- 
ETER TENTS EXPLANATION 

Channel 1 Assignment Symbols (ss) 
ss 1403 Printer 

ss Card Reader 

ss Card Punch 

Channel 2 Assignment Symbols 
ss 1403 Printer 

ss Card Reader 

ss Card Punch 

Channel 1 Paper Tape Reader Assign- 
ment Symbol 

7 ss Paper Tape Reader 

Channel 2 Paper Tape Reader Assign- 
ment Symbol 

8 ss Paper Tape Reader 

The following statement could be used to describe 
a system with a 1403 Printer and 1402 Card Read 
Punch on channel 1, and an 1101 Paper Tape Reader 
on channel 2: 

16 21 

GEN01 P1,R1,X1,,,,,PT 

Tape Units (GEN02) 

The genos macro statement is used to declare the tape 
units available to the system. A separate GEN02 state- 
ment must be made for each channel. 



PARAM- 
ETER 
1 



CON- 
TENTS 

/MDM/ 



EXPLANATION 

Use this parameter if the system will 
include the Core Image file (see 
GEN08). If included, this parameter 
must be used in the GEN02 statement 
for each channel. This parameter must 
be specified if Checkpoint and/or the 
Storage Print utility program are de- 
sired. 
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PARAM- 
ETER 

2 



CON- 
TENTS 
C 



4-12 ss, (etc. 



EXPLANATION 

Channel number for the units declared 
in this statement. 

Assignment symbol for unit in the 
channel specified in parameter 2 of 
this statement. 

Assignment symbols for units 1 through 
9 on the channel specified in param- 
eter 2 of this statement. (No skipping 
of unit numbers is permitted - that is, 
"ss„ss" is an invalid entry. ) 

The following statements could be used to declare 
a Core Image file, five tape units on channel 1, five on 
channel 2, and three on channel 3: 

16 21 

GEN02 /MDM/,1,A0,A1,A2,A3,A4 

GEN02 /MDM/,2,B0,B1,B2,B3,B4 

GEN02 /MDM/,3,C0,C1,C2 



Disk Areas (GEN03-GEN06) 

The macro statements geno3 through GEN06 are used 
to define physical units in disk storage. The four 
macros apply, respectively, to disk modules on chan- 
nels 1 through 4. The information given below is ap- 
plicable to all four macros; the only distinction be- 
tween them is the channel identification established 
by the macro name. 

EXPLANATION 

Assignment symbol for the area de- 
fined by the next two parameters, 
a — access mechanism, 
m — module number, 
tttt — starting track address, 
hr — two-digit identifier of the track 
(HA2) or of the appropriate rec- 
ord area on the track. 
Ending track address. 
The pattern of parameters 1-3 is re- 
peated for each disk area defined 
within the module(s) on this chan- 
nel. Three areas can be defined per 
card; fifteen areas can be defined per 
macro statement (see below). 



PARAM- 


CON- 


ETER 


TENTS 


1 


ss 



amtttthr 



3 
4-45 



eeee 

ss, 

amtttthr, 

eeee, 

(etc.) 



Special Considerations 

1. Each of these macro statements (geno3-geno6) 
can consist of one card containing the macro name in 
columns 16-21, immediately followed by one through 
four continuation cards. (Continuation cards differ 
only in that columns 16-21 are left blank.) Since three 
areas can be defined per card, fifteen areas can be de- 
fined per macro statement. If more than fifteen areas 
are to be defined in the modules on a particular chan- 
nel, then the macro statement for that channel must 
be repeated. For example, if twenty areas are to be 



defined in modules and 1 on channel 2, two GEN04 
macro statements are required. (The first would con- 
sist of five cards defining fifteen areas, and the second 
would consist of two cards defining the other five 
areas. ) 

2. Although each area defined must be entirely con- 
tained within one module, there is no restriction 
against defining, by one macro statement, areas within 
different modules. 

3. Autocoder can process a maximum of ninety-nine 
genoi through geno? macro statements. This factor 
should be considered in determining whether to begin 
a new macro statement or to use continuation cards 
for definition of disk areas. (Only cards with a macro 
name in columns 16-21 count toward the limit of 
ninety-nine. ) 

Example 

The following statements could be used to define four 
areas in module on channel 1, two areas in module 1 
on channel 1, and two areas in module on channel 4: 

16 21 

GEN03 EA,001543AA,1943,EB,002700BA,3150, 
EC,003543AA,3943,ED,004700BA,5150, 
GA,010000AA,5000,GB,010000BB,5000 

GEN06 KA,005000AA,7500,KB,005000BB,7500 



1311 Disk(GEN07) 

The geno7 macro statement is used to define physical 
units on 1311 disk drives. This macro statement per- 
forms the same functions for 1311 Disk Storage units 
that the geno3-geno6 statements perform for 1301 and 
2302 Disk Storage units. 

The geno7 macro statement defines physical units 
in two ways: 

1. It defines a physical unit in terms of a disk drive 
number, a beginning sector address, and an ending 
sector address. The beginning sector address is known 
as the lower limit, and the ending sector address is 
known as the upper limit. In this case, the physical 
unit consists of the sectors starting at the lower limit 
and continuing through the upper limit. This type of 
physical unit is called an unlabeled physical unit. 
It is analogous to a 1301 physical unit. ^ 

2. It defines a physical unit in terms of the disk 
drive number and the label for a specified portion 
of the disk pack. In this case, the beginning and end- 
ing sector addresses of the physical unit are taken from 
the header label. This type of physical unit is called 
a labeled physical unit. 

Either a labeled or an unlabeled physical unit can 
be associated with a file that is to be processed either 
sequentially or nonsequentially. However, for a non- 
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sequentially processed file, the definition of the physi- 
cal unit is used only to determine the channel num- 
ber. Sector limits and labels serve no useful purpose 
with a nonsequential file, since the disk address of 
each record to be processed must be provided by the 
programmer. 

Parameters 1 and 2 in the operand field of the state- 
ment must be entered as the first two operands in 
each geno7 macro statement. The first two parameters 
are followed by groups of three parameters, with 
each group defining a physical unit. The contents of 
parameters 3, 4, and 5 differ when defining an un- 
labeled or a labeled physical unit, as indicated in 
the following listing: 



PARAM- 
ETER 



CON- 
TENTS 

1311 



EXPLANATION 



For an unlabeled unit: 
3 ss 



4 dmmmmmm 



This entry specifies that the physical 
unit is being defined on a 1311 disk 
drive. 

This number specifies the channel to 
which the disk drive bearing the disk 
pack is attached. The entry can be 
either 1 or 2, since 1311 disk drives 
can be attached to only channel 1 
or channel 2. 

The two-character assignment symbol 
that is to be associated with the disk 
area defined in the next two param- 
eters. 

d— the alternate drive-code digit for 
the disk drive on which the disk pack 
is located. The digit is either 2 4 
6, or 8. 

mmmmmm-the six-digit starting sec- 
tor address. 

The low-order five digits of the end- 
ing sector address. This five-digit ad- 
dress is interpreted as though it were 
preceded by a zero. 

The two-character assignment symbol 
that is to be associated with the disk 
area defined by the next two param- 
eters. 

4 d The alternate drive-code digit for the 

disk drive on which the disk pack is 
located. The digit is either 0, 2, 4 6 
or 8. 

5 nn The two-digit label number (00-18) 

that indicates the position of the 
label in the label track on the disk 
pack. The label must contain the sec- 
tor address limits for the physical 
unit. 

The pattern of operands 3, 4, and 5 is repeated 
throughout the remainder of the macro statement. 
Groups defining labeled and unlabeled physical units 
can be intermixed on the same card. 

The coding in the example below defines the entire 
disk pack on drive of channel 1 as an unlabeled 



nnnnn 



For a labeled unit: 
3 ss 



physical unit. In addition, the macro statement defines 
six labeled physical units on the disk pack. 
16 21 

GEN07 1311,1 ( DA,0000000,19999,DB 00 
DC,0,01,DD,0,02,DE,0,03,DF,oW 
DG,0,05 

Monitor Definitions (GEN08) 

The GEN08 macro statement is used to specify system 
information that affects the construction of the Moni- 
tor. 



PARAM- 
ETER 



CON- 
TENTS 

dcfltmwpra 



EXPLANATION 



3 

5 
7 
9 



d — Data Processing System 
1 1410 
7 7010 
c - Core-Storage Size (highest address 
of the machine) 
39999 
59999 
79999 
99999 
f — SOF Residence 
Tape 
9 Disk 
1 - System File Tape Labels 

No labels 

1 Standard 80-character labels 

2 Standard 120-character labels 
Note: During System Generation for a tape-oriented system 

a labeled source System Generator file cannot be used to pro- 
duce an unlabeled output System Generator file. 

t — Tele-processing Supervisor 

Monitor does not include the 

Tele-processing Supervisor. 
9 Monitor does include the Tele- 
processing Supervisor, 
m — Core Image File 

System does not include Core 

Image File. 
9 System does include Core 
Image File, 
w — POW Program 
Not included 

9 POW program included for 
Standard Print and/or Stand- 
ard Punch Units, if those units 
are tape or if Variable Print 
and Variable Punch are cho- 
sen. If both units are Unit 
Record, or both units are 
omitted (specified as "none"), 
or either combination of Unit 
Record and "none" is speci- 
fied the POW program can- 
not be included. (A descrip- 
tion of the POW program is 
in Operator's Guide, Form 
C28-0351.) 
p — Standard Print Unit 

None 

1 1403 Printer 

2 Tape unit 

3 Variable unit 

Note: If Variable Print is chosen, then Variable Punch 
must also be chosen. (See "System File Sharing and Device 
Switching Feature" in the publication System Monitor.) 
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r — Standard Punch Unit 

None 

1 Unit-record punch 

2 Tape unit 

3 Variable unit 

Note- If Variable Punch is chosen, then Variable Print must 
also be chosen. (See "System File Sharing and Device Switch- 
ing Feature" in the publication System Monitor. ) 
a — Alternate Input Unit 
None 
9 AIU capability is included. 

2 nnnnn Tele-processing System; Area Reserved 

nnnnn - Number of core-storage posi- 
tions to be reserved perma- 
nently for TP programs. (If 
no area is reserved, this pa- 
rameter is omitted. ) 

3 nn Lines-Per-Page 

Number to be stored in Resident 
Monitor's Communication Region at 
/LIN/. A two-digit entry must be 
made whether or not the Standard 
Print Unit is specified. (00 is a valid 
entry. ) 

4 n or nn Console Input Area 

This parameter specifies the number 
of core-storage positions to be re- 
served in the Resident Monitor as the 
console input area: 5-20. For Tele- 
processing systems, the parameter 20 
will be assigned automatically. If the 
File Organization System is used, a 20 
must be specified. 
5 jmt Control Card Recording 

j -JOB Card Punching 

JOB cards are not to be re- 
corded on the Standard Punch 
Unit. 
9 JOB cards are to be recorded 
on the Standard Punch Unit, 
m — Monitor Control Cards — 
Standard Print Unit 
Monitor control cards, exclud- 
ing the job card, are not to 
be recorded on the Standard 
Print Unit. 
9 All Monitor control cards are 
to be recorded on the Stand- 
ard Print Unit, 
t — Monitor Control Cards-Console 

Monitor control cards are not 
to be recorded on the console 
printer. 
9 All Monitor control cards are 
to be recorded on the console 
printer. 
Note: It is recommended that all 
Monitor control cards be recorded 
on the console printer so that 
diagnostic messages can be read- 
ily associated with the error con- 
ditions. 
6_14 Assignment Symbols (See Note) 

6 ss System Operating file (required) 

7 ss Standard Input Unit (required) 

8 ss Alternate Input Unit (optional) 

9 ss System Library file (optional) 

10 ss Standard Print Unit (optional) 

11 ss Standard Punch Unit (optional) 

12 ss TP Library file (optional) 



PAHAM- CON- EXPLANATION 

ETER TENTS 

13 ss Temporary Storage file (optional) 

14 ss Core Image file (optional) 

Note: Parameters 10, 11, and 14 are classified as optional; 
however if these system files are included, and if they are not 
assigned by this macro statement, ASGN cards for these files 
must precede the first JOB card during initialization of the 
system. . 

Parameters 8, 9, 12, and 13 are also classified as optional; 
these files, if included at the installation, may be assigned dur- 
ing initialization or any time prior to their use by the system. 
Furthermore, 12 and 13 must be assigned before the TP com- 
plex is opened. 

15 SNAP Use this parameter if the Snapshot 

capability is to be included in the 
Resident Monitor for unusual end of 
program. (Dependent program un- 
usual-end-of-program situations will 
cause a Snapshot of all of core stor- 
age.) Otherwise, omit the parameter. 

16 , This parameter is reserved for system 

expansion. Currently it is to be omitted. 

17 HALT Use this parameter to cause a halt in 

the Resident Monitor Wait-Loop 
(/WAT/) routine. 

18 camtttthh This parameter is specified only if the 

File Organization System will be used. 
The parameter indicates the beginning 
track address of the File Organization 
System File Directory and Index area, 
"c" is the channel, "a" is access mech- 
anism, "m" is the module, "tttt" is the 
track number, and "hh" is the home 
address. 
If a continuation card for gen08 is needed, columns 16-21 
should be left blank. 

Symbolic Unit Definitions 

The number of reserve units, work units, and Tele- 
processing units to be included in the Monitor's as- 
signment tables are specified in three macro state- 
ments (geno9, genio, and genu). Selection of these 
symbolic units depends, in part, upon the nature of the 
object programs to be executed. Autocoder programs 
can refer to all three types of symbolic units, cobol 
programs can refer to work or reserve units, fobtban 
programs can refer to only work units. Thus, the user 
must ensure that symbolic units are provided for both 
general system functions and object-program func- 
tions. For example, if a fobtban object program is to 
address fobtban unit 4, mwi (the equivalent symbolic 
work file - see FORTRAN publication) must be speci- 
fied in the genio macro statement. 

Reserve Units (GEN09) 

The geno9 macro statement specifies the number of 
reserve units whose names are to be included in the 
Monitor's assignment tables. The names will be as- 
signed to the reserve units sequentially, first numeri- 
cally and then alphabetically. (That is mbo, mbi, . . . 

MB9, MBA, MBB, . . . MBZ.) 
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norm 
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Number of reserve units: 1-36. (Note 
that the number "7" makes available 
symbolic units and names MRO 
through MR6, not MR7.) 

| Note: At least one reserve unit must be defined for 
subsequent use by System Generation. 

Work Units (GEN10) 

The genio macro statement specifies the number of 
work units whose names are to be included in the 
Monitor's assignment tables. The names will be as- 
signed to the work units sequentially, first numerically 
and then alphabetically. (That is, mwo, mwi, . . 

MW9, MWA, MWB, . . . MWZ.) 



PARAM- 
ETER 
1 

2-37 



CON- 
TENTS 

n ornn 

ss, (etc.) 



EXPLANATION 

Number of work units: 1-36 
Assignment Symbols: Entries in pa- 
rameters 2-37 are optional. If made, 
they serve the same functions as an 
ASGN card. Assignment symbols will 
be supplied to work units as follows: 

MWO parameter 2 

MWI parameter 3 

MW2 parameter 4 

etc. 

Note: At least one unit should be left unassigned 
for subsequent use by System Generation. 

Tele-processing System Units (GEN1 1) 

The genu macro statement is used to specify the 
number of Tele-processing system units to be included 
in the Monitor's assignment tables. The names of 
these units will be assigned sequentially, first numer- 
ically and then alphabetically. (That is, mto, mti, 

MT9, MTA, MTB, . . . MTZ. ) 

Note: This macro statement must always be made. 
For installations not including a tp system, the oper- 
and field must be blank. 



EXPLANATION 

Number of Tele-processing system 
units: 1-36 

Assignment Symbols: Entries in pa- 
rameters 2-37 are optional. If made, 
they serve the same functions as an 
ASGN card. Assignment symbols will 
be applied to the Tele-processing sys- 
tem units as follows: 

MTO parameter 2 

MTI parameter 3 

MT2 parameter 4 

etc. 



Tele-processing Directory Definitions (TPDIR) 

The tpdir macro statement is used by the tp Super- 
visor to reserve the appropriate amount of core stor- 
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ss, (etc.) 



age for the tp Directory. This macro must be issued 
by the user at System Generation and is usually placed 
at the end of the macro packet. This statement is used 
only by installations including a tp system. 



PARAM- 
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1 



CON- 
TENTS 
XXX 

yyy 



EXPLANATION 

The total number of user programs 
resident in the TP Library. 
The maximum number of TP pro- 
grams the user will have in TP core 
storage at any one time. 



Device Definitions for Resident IOCS (DEVDF) 

The devdf macro statement defines the channel orien- 
tation of all input/output devices (except ibm 1301 
and ibm 2302 Disk Storage units) included in the sys- 
tem. One macro statement must be included for each 
channel containing any of the devices indicated by 
parameters 2 through 8, below. The dskdf macro 
statement must be used to indicate the channel orien- 
tation of ibm 1301 and 2302 Disk Storage units. 



PARAM- 
ETER 
1 



CON- 
TENTS 

1,2, 3, or 4 



EXPLANATION 



1402 or 1442 



1403 



Channel number of devices described 
in this card (one macro per card). A 
separate macro statement is used for 
each channel. 
729 Tape Unit Type 

If 729 magnetic tape units are the 
only type of tape unit attached to this 
channel. 
7330 If one or more of the tape units at- 

tached to this channel is an IBM 7330. 
Card Reader/Punch 
If an IBM 1402 Card Read Punch or 
1442 Card Reader is attached to this 
channel. 
Printer 

If an IBM 1403 Printer is attached to 
this channel. 
1011 Paper Tape Reader 

If an IBM 1011 Paper Tape Reader is 
attached to this channel. 
TP Tele-processing Devices 

If an IBM 1009, IBM 1014, IBM 
1050, IBM 7770, or a telegraph de- 
vice is attached to this channel. 
PTC If a PTC unit is attached to this chan- 

nel. 

If present, this parameter indicates the 
number of IBM 1311 Disk Storage 
Drives attached to the channel. This 
( I0 ) parameter must not be used to pro- 

vide information on IBM 1301 or 
IBM 2302 Disk Storage units. 
SI, S2, S3, S4, The letter S is used as a prefix to the 
or S5 number of drives to indicate that the 

scan disk special feature is being 
used. 

The following statements would be used to describe 
a system that has 729 tape units, a 1402 Card Read 
Punch, and a 1403 Printer on channel 1, telegraph 



1, 2, 3, 4, or 5 
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devices and 7330 tape units on channel 2, and a mix- 
ture of 729 and 7330 tape units on channel 3: 

16 21 

DEVDF 1,729,1402,1403 
DEVDF 2,7330„„TP 
DEVDF 3,7330 

IBM 1301/2302 Disk Definitions for Resident IOCS 
(DSKDF) 

The dskdf macro statement is used to specify the num- 
ber and channel orientation of the disk modules avail- 
able to the system. (Another function of this macro 
is discussed under the explanation of parameters 3-21. ) 
One statement is to be made for each channel to which 
disk modules are attached. 



PARAM- 
ETER 



CON- 
TENTS 

1,2, 3, or 4 



EXPLANATION 

Channel number for modules on this 
card. 

Note: To obtain a shared-file IOCS 
generation, the channel number must 
have a prefix of the type of the gen- 
eration desired (A, B, C, or D, ex- 
plained under "Shared Disk Files"). 
For example, the channel entry for a 
channel 1 IOCS generation with no 
arm-sharing abilities would be Al. 

2 00 Access-Mechanism/Module 

The entry in parameter must be for 
access mechanism 0, module 0. 

3-21 am The entries in parameters 3-21 may 

be in any order. The following 
should be considered in determining 
the order: during the execution of 
object programs, the IOCS will, for 
each channel, determine the availabil- 
ity of an access-mechanism/module 
combination before issuing a Seek 
Disk or any other disk input/output 
instruction. The order in which the 
availability is tested is the order in 
which the parameters appear in pa- 
rameters 2-21. Thus, "00" is always 
tested first, next the combination in 
parameter 3, and so on.. 

The following statements could be used for a system 
with four modules of disk storage on channel 2, and 
two modules on channel 3: 

16 21 

DSKDF 2,00,01,02,03 

DSKDF 3,00,01 



IOCS Definitions (IOKDF) 

The iokdf macro statement is used to specify the in- 
clusion of certain iocs routines to meet the require- 
ments of the system's dependent programs. This macro 
statement must immediately follow the devdf and 
dskdf macro statements. 



PARAM- 
ETER 

1 

2 



CON- 
TENTS 



1410 or 7010 



D 



4 
5 



NSEQ 



EXPLANATION 

Machine type 

80-Character Tape Label Routines 
No exits will be used by dependent 
programs. 

Exits A, D, G, and N, and return 
points /LRC/, /LRF/, /IBM/, and 
/LRR/ will be used by dependent 
programs. Reading, writing, and check- 
ing functions are not to be provided 
by the IOCS. 

All exits except C, F, J, L, and Q, and 
all return points except /LRB/, /LRE/, 
/LRH/, /LRK/, and /LRP/, will be 
used by dependent programs. Reading 
and writing, but not checking, func- 
tions are to be provided by the IOCS. 
All 80-character label routines are to 
be provided by the IOCS. 
If the Data File Generator is to pro- 
duce a labeled file, the "D" parameter 
must be specified. 
120-Character Tape Label Routines 
n is the letter A, B, C, or D, as speci- 
fied for parameter 2. If operand of 
C is given, 120-character label is read 
— but the following tape mark is not 
spaced over. 

Note: If both 80-character and 120- 
character label routines are to be in- 
cluded in the IOCS, then parameters 
2 and 3 must specify the same code 
letter. 

m is omitted if only those label rou- 
tines for 120-character tape labels are 
to be included in the IOCS, 
m is the number 1 if only those label 
routines for 100-character 1311 labels 
are to be included. 

m is the number 2 if label routines 
for both 120-character tape labels and 
100-character 1311 disk labels are to 
be included. 

n is the letter A, B, C, or D, as speci- 
fied for parameter 2. 
Error statistics are to be accumulated 
by the IOCS. 

Service routines will be included in 
dependent programs. That is, the 
DTF INTADDR entry will be used. 

This parameter applies only to a sys- 
tem with IOCS defined for 1311 Disk 
Storage. It is used if all DTF entries 
in the programs being used have 
NSEQ as the first operand of 
FILEFORM. Use of this operand will 
result in a smaller Resident Monitor. 
Disk files requiring specification of 
operands 2 and/or 3 of the DTF 
FILEFORM entry will be used by de- 
pendent programs. 

Write Disk Checks are to be taken. 
That is the WDC operand will be 
used in the DTF ERRCHECK entry. 
(This parameter is available for sys- 
tem expansion; currently, it is to be 
omitted. ) 
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Checkpoint functions will be required 
by dependent programs. The third 
record of each checkpoint triplet is to 
begin at location xxxxx. (This address 
will be stored in the Resident Monitor's 
Communication Region at IOGR.) 
This address must be provided if the 
IOCS checkpoint facilities and/or the 
Storage Print utility program are to be 
used. (Refer to GEN02 and GEN08 
macros. ) It is recommended that loca- 
tion xxxxx be about 8,000 positions 
below the top of core storage. 

Special Considerations for System File Labels 

If the user specifies in the genos macro statement that 
system files are to have tape labels, then parameter 2 
or 3 must be specified in the iokdf macro to provide 
the iocs routines for those labels. Furthermore, only 
"A" or "D" may be used in those parameters. 

Note: The Linkage Loader expects that the first 
eight characters of the phase name will be "linkload." 
Any two characters may follow, making the format 
"linkloadxx." If this format is not followed, the Link- 
age Loader will not build any symbol tables. 



Random-Processing Disk Module Definitions 
(GENRM) 

The genbm macro statement defines the disk modules 
that are to be made available for random processing. 
(Continuation cards may be used for this macro state- 
ment, if necessary. ) 



PARAM- 
ETER 
1-40 



CON- 
TENTS 

ccm, ccm, 
(etc.) 



EXPLANATION 

"c" is the channel character of the ap- 
propriate x-control fields. (As shown, 
this must appear twice. ) 
"m" is the identifying module number 
(0-9). 

Note: The GENRM macro may be 
compiled by a separate Autocoder run. 
The resultant relocatable module must 
be combined as part of a program and 
loaded through the SIU. 
It is recommended that IBRANDOM1, 
which results from GENRM, be 
placed in the Relocatable Library be- 
tween the modules IBRANDOM and 
IBRANDOM2; however, it may be lo- 
cated wherever the user wishes. 
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System Generation Control Cards 



This section contains descriptions of the control cards 
that are used to direct the System Generation process. 
The control cards for programs that are unique to the 
System Generation function are described completely. 
The control cards for programs that are used for data 
processing as well as for System Generation and that 
are, therefore, documented in other publications, are 
described in this publication solely from the viewpoint 
of System Generation. 



/Monitor Control Cards 

In addition to the functions and entries described in 
the publication, System Monitor, the Monitor exeq 
card can have the following entries that are unique 
for System Generation: 
1. In the exeq card for sgi (mon$$ exeq sgi) : 



CAM) 

COLUMN 



CON- 
TENTS 



59 3, 5, 7, or 9 



EXPLANATION 

Indicates that the actual machine size 
being used for System Generation is 
other than that specified in the Moni- 
tor (at /AMS/) of the source file. 
This is intended primarily to specify, 
for the initial System Generation, that 
the machine has more than 40,000 
positions. 

3- 40K 

5- 60K 

7- 80K 

9 - 100K 

2. In the exeq card for SG2 (mon$$ exeq sgs) : 



CARD 
COLUMN 



CON- 
TENTS 



EXPLANATION 



CABD CON- EXPLANATION 

COLUMN TENTS 

59 3, 5, 7, or 9 This must be the same as that 

punched in column 59 of the EXEQ 
SGI card described above. 

60 Tape labels on the new SOF (appli- 
cable only to tape-oriented systems): 

blank No labels 

1 80-character labels 

2 120-character labels 

Note: If tape labels are used, this 
EXEQ card must be immediately fol- 
lowed by a card specifying the infor- 
mation to be used in writing those 
labels: 
1 6 80 

1HDR (label information) 

The label information must conform 
to the IOCS standard label format. 
The field "File Identification" must 
contain IBMSYSTEMb. Refer to the 
publication, Basic Input/Output Con- 
trol System. (For 120-character labels, 
SG2 adds a 40-position blank field to 
the 80 characters taken from the card. ) 
This card is used only once: when 
changing to system file labels from a 
system that does not use file labels. 

Note: The mode sg Monitor control card must be 
included on the sru if the Linkage Loader is to be 
executed during a System Generation run. 



Linkage Loader Control Cards 

In addition to the functions and entries described in 
the publication, System Monitor, the Linkage Loader 
phase card may have the following entries that are 
unique to System Generation: 



57 any character Any character, except blank, indicates 
to SG2 that SGI only updated an al- 
ternate relocatable library and that the 
printed output of SG2 is to consist 
solely of names of the relocatable li- 
brary modules. If this column is blank, 
the SG2 printout will be a full listing 
of the SOF (or SGF) generated. 
(Italicized words above apply only to 
a tape-oriented system. ) 

58 any character Largest possible records are to be 
built. If this column is blank, the 
blocking factor for absolute-format 
programs is 2,165. Note that any en- 
try in this field, except blank, will 
override any specification given in the 
first PHASE card of a program. See 
the following description of the addi- 
tional entries that can be made in the 
Linkage Loader PHASE card. This 
column is not used for a disk-oriented 
system. 



CABD con- 

COLUMN TENTS 

61 1 or 3 



EXPLANATION 



This entry indicates that a directory is 
to be inserted at this point. If the 
entry is "1", the Major Phase Direc- 
tory (Directory 1) is inserted. If the 
entry is "3", the Macro Library Di- 
rectory (Directory 3) is inserted. 
Note: The one Directory 1 request 
permitted for a disk system is re- 
served for the Transitional Monitor. 

62 M R, or C This entry indicates that the macro 

Library, a Relocatable Library, or the 
Create Library is to be inserted at this 
point. ("R" applies only to a tape- 
oriented system. ) 

63 any character If this column is not blank, the abso- 

lute format records are "largest possi- 
ble." If the column is blank, then the 
size is 2,165 characters per record. 
("Largest possible" refers to tape- 
oriented systems only. ) 
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SG Control Cards 

The remainder of this section describes the control 
cards used to perform library maintenance functions 
with the sgi and SG2 programs. These cards (here- 
after termed SG control cards) are divided into four 
classes, in accordance with the type of library for 
which they are used. (Class i is an exception, in that 
the one card in this class applies to all three library 
types. ) 

In the following material the term sgfx refers to the 
file from which the System Generation is being per- 
formed - which can be the Master file, an sgf, or an 
sof. The term SGFy refers to the new file being created 
by the System Generation - which can be either an 
sgf or an sof. 

Tables are provided at the end of this section to 
show the grouping of the sg control cards for presen- 
tation to sgi and SG2, and to summarize the library 
maintenance functions and control card formats. 

Note: No SG control card may contain any punches 
in columns 1-5. 

Class I - The INCLD Card 

This card directs the System Generation programs to 
copy an entire program or library from sgfx to SGFy. 
16 21 

INCLD name 
The incld card has two functions. The specific func- 
tion performed is determined by the nature of the 
element named in the operand. 

If name is the identifier of an absolute format pro- 
gram on the System Generation source file (sgfx), the 
incld card directs the System Generator to copy the 
program onto either the Job file for a tape system or 
the output unit for a disk system. 

If name is the identifier of a Create or Relocatable 
Library on the sgfx, the incld card directs the System 
Generator to insert the library at this point on the 
SGFy. The library must have been previously refer- 
enced by a locat card, and updated or copied. The 
placement of the Macro Library on the SGFy is con- 
tingent on the placement of the Autocoder processor. 
If the SGFy is disk-oriented, the Macro Library will be 
placed at the end of the absolute section. 

For example, to simply copy Autocoder from the 
sgfx to the SGFy, the following card would be used: 
16 21 

INCLD AUTOCODER 

Class II Control Cards — Macro Library 

Class ii control cards pertain to all functions concern- 
ing the Macro Library. 



LOCAT Control Card (Class II) 

A locat control card must be used to locate the Macro 
Library before a library maintenance function may be 
performed. This card must appear before any group 
of insee, heplc, or delet control cards that pertain to 
the Macro Library. 

Columns 1 through 5 of the macro cards must be 
punched and these cards must be in ascending order. 
There are two forms of this card that pertain to 
the Macro Library: 

16 21 

LOCAT M,AUTOCODER 
16 21 

LOCAT M.MACROLIB 
The first card is used to locate the Macro Library 
on a tape-oriented sgfx. The second card is used to 
locate the Macro Library on a disk-oriented sgfx. 

INSER Control Card (Class II) 

The inser card directs the System Generator to per- 
form maintenance on the total Macro Library or on 
some given macro. 
Format 1 

16 21 

INSER M 

This format of the inser card directs the System 
Generator to copy the entire Macro Library onto either 
mwi for a tape system or the output unit for a disk 
system. This card must be preceded by the locat card. 

Format 2 

6 16 21 

alpha INSER M 

This format of the inser card directs the System 
Generator to copy to the end of the Macro Library 
and to insert the library element alpha at the end of 
the library. The new element must follow the inser 
card in the sru. 

Format 3 

6 16 21 

name INSER M,aaaaa 

This format of the inser card directs the System 
Generator to insert new statements after the state- 
ment with sequence number aaaaa in macro name. 

The new statements must follow the inser card in 
the siu. The statements of macro name are not re- 
sequenced. 

REPLC Control Card (Class II) 

Format 1 

6 16 21 

name REPLC M 

This format of the replc card directs the System 
Generator to replace macro name with a new element 
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of the same name. The element must follow the replc 
card in the siu. 
Format 2 

6 16 21 

name REPLC M,aaaaa,bbbbb 

This format of the eeplc card directs the System 
Generator to delete from macro name the statements 
with sequence numbers aaaaa through bbbbb, and to 
replace these with new statements. The new state- 
ments must follow the replc card in the sru. The state- 
ments of macro name are not resequenced by the 
System Generator. To replace a single statement, 
aaaaa is equal to bbbbb. 

The DELET Control Card (Class II) 

Format 1 

6 16 21 

name DELET M 

This format of the delet card directs the System 
Generator to delete the element name from the Macro 
Library. 
Format 2 

6 16 21 

name DELET M,aaaaa,bbbbb 

This format of the delet card directs the System 
Generator to delete statements aaaaa through bbbbb 
from macro name. To delete a single statement, aaaaa 
must equal bbbbb. No resequencing is performed by 
the System Generator. 

Class III Control Cards - Create Library 

The Class m control cards direct the System Generator 
to perform operations on the Create Library. 

The Create Library is a collection of Linkage Loader 
control card packets. Each packet has a name by 
which it can be called. When it is called, normally 
through the cheat control card, the 'System Generator 
extracts the named packet from the library and places 
its contents on mw2. mw2 must always be a tape unit, 
and the Linkage Loader must be informed that a 
Create packet has been selected. The user gives this 
information to the Linkage Loader via the input con- 
trol card. 

LOCAT Control Card (Class III) 

A locat card must be used to locate the Create Li- 
brary before the library maintenance functions may 
be performed. This card must appear before any group 
of inseb, beplc, delet, or genek packets that pertain 
to the Create Library. 

There is one form of the locat control card as it 
pertains to the Create Library: 

16 21 

LOCAT C.CREATLIB 



INSER Control Card (Class III) 

The inseb card directs the System Generator to per- 
form maintenance functions on the total Create Li- 
brary, or on some given Create packet. 

Format 1 

16 21 

INSER C 
This format of the inser card directs the System 
Generator to copy the entire Create Library onto either 
mwi for a tape system or the output unit for a disk 
system. The Create Library must be located by a 
locat card immediately preceding the inser card. 

Format 2 

6 16 21 

name INSER C 

This format of the inser card directs the System 
Generator to copy to the end of the Create Library, 
and to insert the library element identified by name at 
the end of the library. 

GENER Control Card (Class III) 

Each packet in the Create Library is identified by a 
header label of the format shown below: 
16 21 

GENER name 

name is the identifying name of the packet (maxi- 
mum of 10 characters ) . 

When format 2 of the inser card or format 1 of the 
replc card is used, it must be followed by a gener 
control card. 

The gener control card must, in turn, be followed 
by the packet of Linkage Loader control cards. 

To use this packet as Linkage Loader input during 
a generation run, the user must use a creat card with 
the same name as was given on the gener card. 

REPLC Control Card (Class HI) 

Format 1 

e 16 21 

name REPLC C 

This format of the replc card directs the System 
Generator to replace the Create packet name with a 
new packet having the same name. The replc card 
must be followed, in the siu, by a gener card, and 
then the packet. 

DELET Control Card (Class III) 
Format 1 

6 16 21 

name DELET C 

This format of the delet card directs the System 
Generator to delete the packet name from the Create 
Library. 
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CREAT Control Card (Class III) 

The cheat card directs sgi to access the Create Li- 
brary (creatlib) for Create packet name, to deblock 
the records of this packet into card-image records, and 
to transfer these card-image records to work file MW2, 
for later input to the Linkage Loader. The format is as 
follows: 

16 21 

CREAT name 

Note 1: mw2 must be a tape unit. 

Note 2: Linkage Loader must be presented with an 
input MW2 control card. 

Note 3: See section, "Creation Charts," for a de- 
tailed list of all Create packets supplied by ibm. 

Note 4: Linkage Loader control cards or object 
decks may be intermixed with cheat control cards and 
will be placed on MW2 in the order in which they are 
received. This allows the user to merge his own pro- 
grams into sequence with ibm programs. Other means 
are also provided for reordering an sgf once the pro- 
grams have been placed on the file in absolute format 
See "INCLD Control Card (Class I)." 



Class IV Control Cards - Relocatable Library 

Class iv control cards direct the System Generator to 
perform operations on a Relocatable Library. 

LOCAT Control Card (Class IV) 

The locat card must be used to locate a particular 
library on the system file (sgf or sof) before the li- 
brary maintenance functions can be performed. 
Format 1 

16 21 

LOCAT B.,namel 
Referring to format 1, name identifies the library. 
name must be left-justified in the operand field, and 
can consist of a maximum of ten characters. 

Format 2: The locat card can also be used to 
change the name of a relocatable library: 
6 16 21 

name2 LOCAT R.namei 

namel is the original name; name2 is the new name. 

ALTLB Control Card (Class IV) 

The ALTLB card is used to locate the Relocatable Li- 
brary currently assigned as the System Library file 
(lib). This card performs the same functions for such 
Relocatable Libraries as does the locat card for any 
type of library residing on the system file (sgf or sof). 
Note: If any Relocatable Library, except those re- 
siding on the sof (or sgf), is to be maintained, that 
library must be assigned to symbolic unit lib. Further- 



more, maintenance of this library is the only function 
that can be performed during this System Generation 
run. Also, see discussion of column 57, exeq sgs con- 
trol card, under "Monitor Control Cards." 
Format 1 

16 21 

ALTLB xxxx 

Referring to format 1, the operand xxxx specifies 
the type of physical unit assigned to lib; this operand 
can be tape, 1301, or 2302. 

ADD Control Card (Class IV) 

The add card directs the System Generator to create 
header information for a new library. The add card 
must immediately precede, in the sru, the records that 
constitute the new library. 

16 21 

ADD R,name 
name is the identifying name that the new library 
is to have (maximum of ten characters). 

INSER Control Card (Class IV) 
Format 1 

16 21 

INSER R 

This format of the inser card directs the System 
Generator to copy an entire Relocatable Library onto 
either mwi for a tape system or the output unit for a 
disk system. The library that is copied must be located 
by a locat (or altlb) card immediately preceding the 
inser card. 

Format 2 

6 16 21 

name INSER R 

This format of the inser card directs the System 
Generator to copy to the end of the Relocatable Li- 
brary being processed, and to insert the module (sub- 
program) name at the end of the library. The module 
can either follow the inser card in the siu or be on the 
Go file. If this format inser card is not followed by 
the module (that is, if the next card in the sru is an- 
other control card), the System Generator automatical- 
ly searches the Go file for module name. 

Format 3 

6 16 21 

namel INSER R,name2 

This format of the inser card directs the System 
Generator to insert module namel in front of module 
name2. If module namel does not follow the inser 
card in the siu, the Go file is searched. If more than 
one module (from the siu) is to be inserted at this 
point, they may follow the module packet for namel, 
without additional inser cards. 
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REPLC Control Card (Class IV) 
Format 1 

6 16 21 

name REPLC R 

This format of the replc card directs the System 
Generator to replace library module name with a new 
module having the same name. The module can either 
follow the replc card in the sru or be on the Go file. 
If this format beplc card is not followed by the module 
(that is, if the next card in the sru is another control 
card), the System Generator automatically searches 
the Go file for the module. 

Format 2 

6 16 21 

namel REPLC B.,name2 

This format of the replc card directs the System 
Generator to delete modules namel through name2, 
and to replace the deleted modules with a single 
module whose identifier is namel. Note that one or 
more modules can be deleted but only one new 
module with namel can be added. If the new module 
namel does not follow the inser card in the siu, the 
Go file is automatically searched. 

DELET Control Card (Class IV) 

Format 1 

6 16 21 

name DELET R 

This format of the delet card directs the System 
Generator to delete module name from the Relo- 
catable Library. 



Format 2 

6 16 21 

namel DELET R,name2 

This format of the delet card directs the System 
Generator to delete modules namel through name2. 



Groups of Control Card Classes 

The four classes of sg control cards must be presented 
to sgi and/or sea in certain groups. The order and 
contents of these groups are determined, in part, by 
the orientation of the system file being used - whether 
it is tape- or disk-oriented. The table below defines 
the groups into which the various classes of sg control 
cards must be divided for proper control of the sgi 
and SG2 programs. 





TAPE 


DISK 


5 


Group 1 

Classes II, III, IV 


Group 1 
Class III* 


Group 2 
Classes 1, III* 


Group 2 
None 


CM 
O 
CO 


Group 1 
None 


Group 1 
Class ] 


Group 2 
None 


Group 2 

Classes II, III, IV** 



* Of Class III cards, only the CREAT card may be used in this group. 
Linkage Loader control cards may be intermixed with the CREAT cards. 
** The Class IV cards must be last in this group. 

Each group must have the following card as its 

last card: 

16 
END 



SUMMARY OF LIBRARY MAINTENANCE: FUNCTIONS AND CONTROL CARDS 



Library 

Maintenance 

Function 



Add an entire library 



Delete an entire library 

Change name of a 

Relocatable library 
Copy of a library (no change) 



Add an element to end of 
a library 

Add a module to middle or 
a I ibrory 



Replace element from SIU 



Replace module from Go File 



Operation 16-20 
LOCAT 



6-15 
Label 



21-72 
Operand 



13 



Delete a library element 



Delete consecutive modules 



Replace several modules with 
one from SILJ 



Maintain external 
Relocatable Library 



Add statements to a macro 



Delete statement from a macro 



Replace macro statements 



(Omission of control -card reference to a library causes its 



Operation 16-20 
ADD 



6-15 
Label 



21-72 

Operand 



Operation 16-20 
INSER 



6-15 
Label 



21-72 
Operand 



Operation 16-20 
REPLC 



6-15 
Label 



21-72 
Operand 



Operation 16-20 
DELET 



deletion.) 



(Locate 



10 



2 11 



6-15 
Label 



21-72 

Operand 



with AL TLB card. Maintain with SG cards as for libra y on System File.) 



10 



10 



Key 1. M,R, or C (library type) 

2. R only 

3. M only 

4. Library name 

5. Element name 

6. Name of module before which new module will be inserted 

7. First module to be deleted 



8. Last module to be deleted 

9. Number of statement behind which new statements 
will be inserted 

10. First element to be deleted or replaced 

1 1 . Last element to be deleted or replaced 

12. Original name 

1 3 . New name 
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IBM Master File — Tape-Oriented System 



This section lists: (1) the assignment symbols that 
must be used by each user for his initial System Gen- 
eration run, (2) the programs available on the Master 
file, and (3) the construction of the basic Resident 
Monitor. This section applies only to a tape-oriented 
system and need not be read by persons interested in 
a disk-oriented system. 

Assignment Symbols for Initial Run 

Arbitrary assignment symbols have been chosen for 
use in the Master file. Therefore, the first run made 
by each user must be made on the basis of these as- 
signment symbols. For the initial run, mon$$ asgn 
cards must be prepared. These cards assign physical 
units to those duties specified under "Basic Concepts 
— Tape-Oriented System." 

The symbols available for assignment to the physi- 
cal units for the initial System Generation run are 
listed as follows: 



PHYSICAL UNIT 

Card Reader 

Printer** 

Punch 

Tape (729 or 7330) 



CHANNEL 1 

ASSIGNMENT 

SYMBOLS 

*R1 
**P1 
**X1 

A0 

Al 

A2 

A3 

A4 

A5 

A6 



CHANNEL 2 

ASSIGNMENT 

SYMBOLS 

R2 
««P2 
**X2 

BO 

Bl 

B2 

B3 

B4 

B5 

B6 



*R1 is assigned as the SIU, but the unit assigned as SIU can 
be changed from the console. A0 is assigned as the SOF, but 
the unit assigned as SOF can be changed from the console. 
"The Variable Print and Punch routines are included but are 
not preassigned. They can be assigned to either unit-record 
or tape devices. 

Programs Available 

The programs available on the Master file for a tape- 
oriented system are: 

IBBOOT 

IBRESMON 

IBTRANSIT 

LINKLOAD 

IBMLIBR 

IBTRANSIT 

SG2 

SG5 

IBTRANSIT 

AUTOCODER 

IBTRANSIT 

SGI 

CREATLIB 

IBTRANSIT 

SORTDEFINE 

IBTRANSIT 

DEFINE 



Bootstrap 

Resident Monitor, including IOCS 

Transitional Monitor 

Linkage Loader 

Relocatable Library 

Additional Copy 

System Generation Program, Part 2 

System Library Update 

Additional Copy 

Processor and Macro Library 

Additional Copy 

System Generation Program, Part 1 

Create Library 

Additional Copy 

Sort Definition 

Additional Copy 

File Organization System Definition 



Basic Resident Monitor 

The basic Resident Monitor on the Master file has the 
following design. 



System: 
With: 



1410 System with 40,000 positions of core storage 

Five-position console input area 

Console printing of all Monitor control cards 

Two channel, tape and unit-record IOCS 

Error statistics 

Variable Print routine 

Variable Punch routine 

POW 



Without: 



1. 
2. 
3. 
4. 
5. 
6. 
7. 

1. 
2. 
3. 
4. 
5. 
6. 
7. 



Labeling 

Tele-processing 

Restart 

Core Image file ( MDM ) 

AIU routine 

User-written service routines 

Snapshot at unusual end of program 



Symbolic units requiring assignment are: 

MGO, MJB, MW1, MW2, MW3, and MR0. 

SPR and SPU require assignment only if Print and Punch are 
wanted. 

Control cards that could be used to generate a Mas- 
ter file are shown in Figure 18. 



16 



21 



M0N*$ 
M0N$$ 
M0Nt$ 
M0N$$ 
M0Nt$ 
M0N$$ 
M0N$* 
MCIN$$ 
MON$$ 
M0N$$ 
M0N$* 



MON$J 



M0N$$ 



M0N$$ 
M0N$$ 



DATE YRDAY 

ASGN SPR.A1 

JOB CREATE TAPE MASTER FILE 

ASGN MW1.B1 

ASGN MH2.A2 

ASGN MH3.B3 

ASGN MJB.B3 

ASGN MG0.A6 

ASGN MR0.A6 

MODE GQ.SG 

EXEQ AUTOC00ER,,,N0FLG,NOPCH 

PST 

HEADRTAPE MASTER FILE 

GEN01P1,R1,X1,P2,R2,X2 

GEN02,1,A0,A1,A2,A3,A4,A5,A6 

GENO2,2,B0,Bl,B2,B3,B<t,B5,B6 

GEN08 1300009330,, 55, 5, 099, A0.R1 

GEN091 

GEN104 

GENII 

DEV0F 1,7330, 1402, 1403 

DEVDF 2, 7330, 1402, 1403 

I0K0F141O,,,4 

ENO 

EXEQ SGI 

L0CATM, AUTOCODER 

INSERM 

LOCATC, CREATLIB 

INSERC 

LOCATR, IBMLIBR 

INSERR 

END 

CREATTMONITOR 

CREATTLINKLOAD 

PHASEIBMLIBR 

CREATTTRANSIT 

CREATTSYSGEN2 

CREATSG5TD 

CREATTTRANSIT 

CREATTAUTOCODE 

CREATTTRANSIT 

CREATTSYSGENl 

PHASECREATLIB 

CREATTTRANSIT 

CREATTSRTDEFIN 

CREATTTRANSIT 

CREATDEFINE 

CREATTTRANSIT 

END 

EXEQ LINKLOAO 

INPUTMW2 

EXEC SG2 

END TAPE MASTER GENERATION 



Figure 18. Control Cards Used to Generate a Master File for 
a Tape-Oriented System 
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IBM Master File — Disk-Oriented System 



This section lists: (1) the assignment symbols and 
disk addresses that must be used by each user for 
his initial System Generation run, (2) the programs 
available on the Master file, and (3) the construction 
of the basic Resident Monitor. This section applies 
only to a disk-oriented system and need not be read 
by persons interested in a tape-oriented system. 

Assignment Symbols for Initial Run 

Arbitrary assignment symbols have been chosen for 
use in the Master file. Therefore, the first run made 
by each user must be made on the basis of these as- 
signment symbols. For the initial run, mon$$ asgn 
cards must be prepared. These cards assign physical 
units to those duties specified under "Basic Concepts 
— Disk-Oriented System." 

The symbols available for assignment to the physi- 
cal units for the initial System Generation run are 
listed in Table 3. 



Programs Available 

The programs available on the Master file for a disk- 
oriented system are: 

IBSGDL System Generation Disk Load Program 

IBBOOT Bootstrap, Resident Monitor, and Transitional 

Monitor 
LINKLOAD Linkage Loader 
AUTOCODER Autocoder Language Processor 
SGI System Generation Program, Part 1 

SG2 System Generation Program, Part 2 

SG5 System Library Update Program 

DSRTDEFINE Disk Sort Definition Program 
UTILITIES Storage Print, Tape Print, Disk Print, 1301 

Format/ Address Generator, 2302 Format/ Ad- 
dress Generator, 1311 Format/Address Gen- 
erator, File Save, File Restore, and Data File 
Generator programs 
DEFINE File Organization System Definition Program 

IBSGDL Additional copy of System Generation Disk 

Load Program 
MACROLIB Macro Library 
CREATLIB Create Library 

IBMLIBR Relocatable Library 



Table 3. Assignment Symbols and Addresses, Disk System 





Channel 1 


Channel 2 




Assignment 


Assignment 


Physical Unit 


Symbols 


Symbols 


Card Reader 


*R1 


R2 


Printer 


**P1 


**P2 


Punch 


**X1 


**X2 


Tape (729 or 7330) 


A0 


BO 




Al 


Bl 




A2 


B2 




A3 


B3 


Disk (see Note 1 ) 


*E1 


Gl 




E2 


G2 




E3 


C3 




E4 


G4 




ES 


GS 




E6 


G6 




E7 


G7 



Cylinders 



20 
40 
25 
20 
15 
15 
10 



AM 



Start 
Track 



End 
Track 



HR 



Note 



00 


0000 


0799 


00 


2,7 


00 


0800 


2399 


00 


3,7 


00 


2400 


3399 


00 


4 


00 


3400 


4199 


00 


5 


00 


4200 


4799 


00 


6 


00 


4800 


5399 


00 


6 


00 


5400 


5799 


00 


6 



* Rl is assigned on the SIU, but the unit assigned as SIU can be changed from the console. 
El is assigned on the SOF, but the unit assigned as SOF can be changed from the console. 
** The Standard Print and Punch variable routines are included but are not preassigned. They can be assigned to either unit-record or 

tape devices. 
NOTES: 

1. Disk must be formatted for ISO cylinders. Format is Load mode with the record address equal to the track address and an HA identi- 
fier of 00. Address format: AMTTTTHA, as explained under "Organization of Data Files on Disk Storage. " 

2. Assign area to Master file by means of console if channel 2 is used. 

3. Assign area E2 or G2 to Relocatable library (LIB) by means of ASGN card. 

4. Assign area to Job file by means of ASGN card. 

5. Assign area to Go file by means of ASGN card. 

6. Assign Work files MW1, MW2, and MW3 by means of ASGN cards. " 

7. When loading the operating section of the Master file onto disk, begin loading at module 0, track 0000. The Relocatable 
Library begins on module 0, track 0800. These areas correspond to El or Gl and E2 or G2. 
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Basic Resident Monitor 

The basic Resident Monitor on the Master file has the 
following design. 

System: 1410 Data Processing System with 60,000 positions 

of core storage 
With: 1. Five-position console input area 

2. Console printing of all Monitor control cards 

3. Two channel, tape, disk, and unit-record IOCS 

4. Error statistics 

5. Write disk check 

6. Variable Print routine 

7. Variable Punch routine 

8. POW 



Without: 1. Labeling 

2. Tele-processing 

3. Restart 

4. Core Image file ( MDM ) 

5. AIU routine 

6. User-written service routines 

7. Snapshot at unusual end of program 

Symbolic units requiring assignment are: 

MGO, MJB, MW1, MW2, and MW3. 
SPR and SPU require assignment only if Print and Punch are 
wanted. 

Control cards used to generate the Master file are 
shown in Figure 19. 



16 
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••* INSERT BOOTSTRAP CARD ••« 
M0N$$ DATE YRDAY 
MCNJ$ ASGN SPR.A1 

M0N$$ JOB CREATE DISK MASTER FILE 
M0N$$ ASGN LIB.E2 
M0N$$ ASGN MJB.E3 
M0N$$ ASGN MG0.E4 
M0N$$ ASGN MW1.E5 
M0N$$ ASGN MW2.E6 
M0NJ* ASGN MW3.E3 
M0N$$ MODE GO.SG 
M0N$$ EXEQ AUt0CO0ER,,,NOFLG,NOPCH 

HEADR DISK MASTER FILE VER. 4 

GEN01P1,R1,X1,P2,R2,X2 

GEN02>1>AO,A1,A2,A3 

GEN02,2,B0,B1,B2,B3 

GEN03E 1,00000000, 0799, E2.0O08O000, 2399, £3,00240000,3399, 
E4, 00340000, 41 99, £5, 00420000, 4799, £6, 00480000, 5399, 
£7,00540000,5799 

GEN04G1, 00000000, 0799, G2, 00080000, 2399 ,G3, 00240000, 3399, 
G4, 00340000, 4199, G5, 00420000, 4799, G6, 00480000, 5399, 
G7, 00540000, 5799 

GEN08 1590009330,, 55 i 5, 009, El, Rl 

GEN09 

GEN104 

GENU 

OEVOF 1,7330, 1402, 1403 

DEVDF2, 7330, 1402,1403 

OSKDFl.OC 

0SK0F2,00 

IOKDF1410,,,4,,,,8 

END 
M0N$$ ASGN MW2.A2 
M0N$$ EXEQ SGI 9 

CREATDMONITOR 

CREATOLINKLOAO 

CREATDAUTOCODE 

CREATDSYSGEN1 

CREATDSYSGEN2 

CREATSG5TD 

CREATDSRTOEFIN 

CREATUTILITIES 

CREATDEFINE 

CREATIBSGDL 

END 
MQN$$ EXEQ LINKLOAD 

INPUTMW2 
M0N$$ EXEQ SG2 9 

LOCATM.MACROLIB 

INSERM 

LOCATC.CREATLIB 

INSERC 

LOCATR.IBMLIBR 

INSERR 

END 
MCN$$ END 

Figure 19. Control Cards Used to Generate a Master File for a Disk-Oriented System 
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Contents of the Libraries 



This section lists the contents of the three libraries — 
Macro, Relocatable, and Create — as they are dis- 
tributed on the Master file. 

Macro Library Contents 

The following Macro Library is contained on both 
the tape- and disk-oriented Master files. On a tape- 
oriented Master, its name is autocoder. On a disk- 
oriented Master, its name is macrolib. 



SEQUENCE 


NAME 


SEQUENCE 


NAME 


1 


GET 


15 


GEN08 


2 


IOCTL 


16 


GEN09 


3 


UNCTL 


17 


GEN10 


4 


DTF 


18 


GENU 


5 


STDIO 


19 


DEVDF 


6 


MONOP 


20 


DSKDF 


7 


SYSIO 


21 


IOKDF 


8 


GEN01 


22 


GENRM 


9 


GEN02 


23 


DUMP 


10 


GEN03 


24 


ENDLD 


11 


GEN04 


25 


LDPTC 


12 


GEN05 


26 


TPDIR 


13 


GEN06 


27 


SPLDF 


14 


GEN07 







The user should refer to the section, "System Gen- 
eration Control Cards," before attempting to perform 
any maintenance function on this library. The Class n 
control cards describe the operations that may be per- 
formed. 

It is also recommended that if the user is not going 

to use an sgf or sof for regeneration functions, he 

should delete the following macros from this library: 

GEN01 GEN06 GENU 

GEN02 GEN07 DEVDF 

GEN03 GEN08 DSKDF 

GEN04 GEN09 IOKDF 

GEN05 GEN10 GENRM 

SPLDF 

For information concerning the use of the above 
macros in generating a system, the reader should refer 
to the section, "System Description Control Cards." 

Relocatable Library Contents 

The following is a list of all the relocatable subpro- 
grams (modules) contained in the Relocatable Li- 
brary (ibmlibr) of both the tape- and disk-oriented 
Master files. The modules are listed below in the order 
in which they are sequenced in the Relocatable Li- 
brary. Refer to the section, "System Generation Con- 
trol Cards," for information concerning operations on 
this library. 



File Organization System Modules 

IBFOSCTL1 
IBFOSCTL2 
IBFOSLOAD0 
IBFOSLOAD1 
IBFOSLOAD2 
IBFOSADD 
IBFOSADD2 
IBFOSUNLOD 
IBFOSOOF 
IBFOSCOF 
IBFOSDG 
IBFOSSG 
File Organization System Definition Module 
IBFOSYSDEF 



Utility Program Module 

SNAPSHOT (If specified, generated as a part of the System 
Monitor or as part of a dependent program. ) 



Tape Sort Program Modules 

IBSRTCOMAN 

IBSRTPRIME 

IBSRTCTLCD 

IBSRTGASSR 

IBSRTGASM3 

IBSRTDUM00 

IBSRTEQUAL 

IBSRTIO101 

IBSRTIO102 

IBSRTIO104 

IBSRTIO105 

IBSRTREPLT 

IBSRTREPLQ 

IBSRTIO103 

IBSRTIO106 

IBSRTP1ASN 

IBSRTDUM01 

IBSRTEQASN (Duplicate) 

IBSRTIO109 

IBSRTIO110 

IBSRTIO107 

IBSRTIO108 

IBSRTIO203 

IBSRTIO201 

IBSRTMNTS2 

IBSRTMNTM2 

IBSRTRPPH2 

IBSRTIO205 

IBSRTIO206 

IBSRTDUM02 

IBSRTAMRG2 

IBSRTIO204 

IBSRTIO202 

IBSRTI0314 

IBSRTIO301 

IBSRTIO302 

IBSRTIO305 

IBSRTIO306 

IBSRTI0399 
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IBSRTMNTM3 

IBSRTMNTS3 

IBSRTRMRG3 

IBSRTLKAD3 

IBSRTIO303 

IBSRTIO304 

IBSRTSQTG3 

IBSRTDUM03 

IBSRTEQASN (Duplicate) 

IBSRTSUPH3 

IBSRTAMRG3 

IBSRTIO307 

IBSRTIO308 

IBSRTIO310 

IBSRTI0311 

IBSRTI0312 

IBSRTIO309 



Disk Sort Program Modules 

IBDSRTCOMN 

IBDSRTPTTP 

IBDSRTPRIM 

IBDSRTGA01 

IBDSRTGA02 

IBDSRTGADM 

IBDSRTEQAL 

IBDSRTRPP1 

IBDSRTOCF1 

IBDSRTMCF1 

IBDSRTIOJ1 

IBDSRTIOK1 

IBDSRTIOL1 

IBDSRTIOM1 

IBDSRTAP21 

IBDSRTDUM1 

IBDSRTEQAS 

IBDSRTAP11 

IBDSRTIOA1 

IBDSRTIOC1 

IBDSRTIOE1 

IBDSRTIOB1 

IBDSRTIOD1 

IBDSRTIOF1 

IBDSRTOCF2 

IBDSRTMCF2 

IBDSRTRPP2 

IBDSRTAP12 

IBDSRTOCF3 

IBDSRTMCF3 

IBDSRTRP13 

IBDSRTRP23 

IBDSRTRP33 

IBDSRTRP43 

IBDSRTRP53 

IBDSRTRP63 

IBDSRTRP73 

IBDSRTRP83 

IBDSRTRP93 

IBDSRTIOR1 

IBDSRTHS13 

IBDSRTDUM3 

IBDSRTAP13 

IBDSRTAP23 

IBDSRTAP33 

IBDSRTAP43 

IBDSRTAP53 



CHAIN Object-Time Modules 

CHAIN 
RETURN 



COBOL Object-Time Modules 



IBCOBOL 

IBCBLADOVR 

IBCBLDSPLY 

IBCBLCMPAR 

IBCBLFLDMP 

IBCBLALTST 

IBCBLSUBSC 

IBCBLACCPT 

IBCBLEXPON 

IBCBLRDINT 

IBCBLDVZER 

IBCBLCLEAR 



FORTRAN Object-Time Modules 



IBINTRP (Programmed interpretations, floating-point) 

OVERFLY 

DVCHK V (Machine interpretations, floating-point) 

IBINTRP J 

IBCOMMON 

IBLABEL 

IBFOERR 

IBINDX1 

IBINDX2 

IBINDX3 

IBEXPF1 

IBEXPFF 

ALOG 

EXP 

EXIT 

AMAXO 

AMINO 

FLOAT 

MAX1 

MINI 

INT 

IFIX 

IBEXPII 

IBBACKSP 

IBREWIND 

IBENDFILE 

SQRT 

ABS 

IABS 

AMAX1 

MAXO 

AMIN1 

MINO 

COS 

SIN 

AMOD 

AINT 

SIGN 

ISIGN 

MOD 

DIM 

IDIM 

ATAN 

SLITE 

SLITET 



Random-Processing Scheduler Modules 



IBRANDOM 

IBRANDOM1 

IBRANDOM2 

IBRANDOM3 

IBRANDOM4 

IBRANDOM5 

IBRANDOM6 



( Should be generated and placed here ) 
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Miscellaneous 
IBLOOKM 

1311 IOCS Modules 

IBCYLOFLO 
IBSCAN1311 

Resident Monitor Modules 

IBMVERSION 

IBZRRTP 

IBBSPTP 

IBSIMTP 

IBABTPM 

IBABDKM 

IBRDSIU 

IBPRTUR 

IBPRTTP 

IBPRTVAR 

IBPRTNONE 

IBPCHUR 

IBPCHTP 

IBPCHVAR 

IBPCHNONE 

IBPPCOMMON 

IBREADAIU 

IBIOARM 

IBAINQUIRY 

IBZRRDK 

IBSIMDK 

Tele-processing Supervisor Modules 

TPPTCCH1 

TPPTCCH2 

TPSTARTCH1 

TP1050CH10 

TP1050CH11 

TP7770CH1 

TP1009CH1 

TP1014CH10 

TP1014CH11 

TPTELCH10 

TPTELCH11 

TPTELCH12 

TPENDCH1 

TPSTARTCH2 

TP1050CH20 

TP1050CH21 

TP7770CH2 

TP1009CH2 

TP1014CH20 

TP1014CH21 

TPTELCH20 

TPTELCH21 

TPTELCH22 

TPENDCH2 

TPSUPER 

TPSUPERDR 

TPSUPERTPO 

TPSUPERDDR 

TPBASSUPER 

TPTAPEDUMP 

TPDISKDUMP 

TPONLY 

TPTAPELDRA 

TPTAPELDRR 

TPDISKLDRA 

TPDISKLDRR 

TPLDRRPROC 

TPLDRDEP 



Transitional Monitor Modules 

IBREADMOCC 

IBSCANM 

IBEXEQM 

IBIOATM 

IBIOATMVAR 

IBSEARCHT 

IBACCOUNT 

IBPOWTRAN 

IBSEARCHD 

IBSPLNITER 

Sort Definition Program Module 

IBSRTDEFIN 
IBDSRTDEF 

Linkage Loader Modules 

IBLNKPROC 

IBLNKGOTAP 

IBLNKINTAP 

IBLNKOUTAP 

IBLNKGODSK 

IBLNKINDSK 

IBLNKOUDSK 

IBCOUPLE 

Miscellaneous 

IBUPPER 

Autocoder Compiler Modules 

IBAU10COMM 

IBAU10INPT 

IBAU10TPE1 

IBAU10TPE2 

IBAU10IOTB 

IBAU20GENR 

IBAU20TPE1 

IBAU20TPE2 

IBAU30ASGN 

IBAU30SCAN 

IBAU30TPE1 

IBAU30SUBR 

IBAU33SUBR 

IBAU33TPE1 

IBAU33RCUR 

IBAU40OTPT 

Go Modules for Compilers 

IBTOCGM 
IBTPCGM 
IBTCCGM 
IBTNCGM 
IBDOCGM 
IBDPCGM 
IBDCCGM 
IBDNCGM 

Autocoder Compiler Modules (continued) 

IBAU40TPE1 
IBAU50TPE1 
IBAU50CREF 
IBAU10DSK1 
IBAU10DSK2 
IBAU10DSK3 
IBAU20DSK1 
IBAU20DSK2 
IBAU20DSK3 
IBAU30DSK1 
IBAU33DSK1 
IBAU40DSK1 
IBAU50DSK1 



54 



COBOL Compiler Modules 



IBCBLCSP01 

IBCBLCSP09 

IBCBLCSP02 

IBCBLCSP03 

IBCBLP0MF1 

IBCBLCST04 

IBCBLCST05 

IBCBLP1MF1 

IBCBLP1MF2 

IBCBLCST06 

IBCBLP1MF3 

IBCBLCST07 

IBCBLP2MF1 

IBCBLCSP08 

IBCBLP2MF2 

IBCBLP2MF3 

IBCBLP2MF4 

IBCBLP3MF1 

IBCBLP3T01 

IBCBLP4MF1 

IBCBLP5MF1 

IBCBLCSD04 

IBCBLCSD05 

IBCBLCSD06 

IBCBLCSD07 

IBCBLP3D01 



FORTRAN Compiler Modules 

IBFTNCMN 

IBFTN05TO 

IBFTN05 

IBFTNIOTO 

IBFTN10TI 

IBFTN10 

IBFTN20TO 

IBFTN20TI 

IBFTN20 

IBFTN25TI 

IBFTN25 

IBFTN05DO 

IBFTN10DO 

IBFTN10DI 

IBFTN20DO 

IBFTN20DI 

IBFTN25DI 

Utility Program Modules 

IBUTILITY 

IBUTILSCAN 

IBTAPEDUMP 

IBDISKDUMP 

IBCOREDCTL 

IBCOREDUMP 

IB01FAGEN 

IB11ADRGEN 

IB1311LBL1 

IB1311LBL2 

IBADDRESR 

IBFILESAVE 

IBFILEREST 

IB02FAGEN 

IBFILEGEN 



Loader Modules for PTC Programs 

TPLDDCP1 
TPLDDCP2 



System Generator Modules 

IBSYSGEN1 

IBSYSGEN2 

IBDSYSGEN1 

IBDSYSGEN2 

IBDSYSGEN3 

IBSGLDLDR 

Tape-to-Disk SOF Load Modules 

SGDLBOOT 

IBDLIO 

IBDLIOA 

IBDLIOB 

IBDLIOC 

IBDLIOD 

IBSGDLDR 

SG4 and SG5 Program Modules 

IBSG4 

IBSG5 

IBSG5D 

IBSG5T 

IBSG5E 

Macro Print and Punch Modules 

IBPRINTMT 
IBPRINTMD 
IBPRINTM 

TP Library Generator Modules 

TPATLIBGEN 
TPADLIBGEN 
TPLIBGENXT 
TPLIBGENXD 
TPLIBGENXP 



Create Library Contents 

The following Create Library is contained on both the 
tape- and disk-oriented Master files. Additional Create 
packets are documented in the following section of 
tables, but they are not provided as part of the Create 
Library. The name of the library is ckeatlib. 

A "T" or "D" prefix on the name of a Create packet 
refers to an exclusively tape-oriented or disk-oriented 
packet. Where there is no prefix, the same package 
applies for both tape and disk. 

TMONITOR 

Includes IBBOOT, IBRESMON, and IBTRANSIT for tape 

system. 

( No provision made for Tele-processing Supervisor. ) 

RESTART 

The CREATRESTART card, if used, must immediately fol- 
low the CREATTMONITOR or CREATDMONITOR card. 

TSRTDEFIN 

TLINKLOAD 

SYSGEN3 

TAUTOCODE 

TCOBOL 

TFORTRAN 

UTILITIES 

Includes Storage Print, Tape Print, Disk Print ( 1301, 2302, 
1311), 1301 Format/Address Generator, 2302 Format/ Ad- 
dress Generator, 1311 Format/ Address Generator, File Save 
(1301/2302), File Restore (1301/2302), and Data File 
Generator (Tape, 1301, 2302) Utility Programs. 
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TSYSGEN1 
TSYSGEN2 
TMACROPRT 
DMONITOR 

Includes IBSGDL and IBBOOT for a disk system. (Resident 

and Transitional Monitor are part of IBBOOT. No provision 

made for Tele-processing Supervisor. ) 
DLINKLOAD 
DAUTOCODE 
DCOBOL 
DFORTRAN 
DSYSGEN1 
DSYSGEN2 
DMACROPRT 
DSKLIBLDR 

To place a Relocatable Library on disk. 
TSYSTEM 
DSYSTEM 
LINKLOADTD 
LINKLOADDT 
TMONTP1 



TMONTP2 

DMONTP1 

DMONTP2 

IBSGDL 

TTRANSIT 

LINKLOADRD 

LINKLOADRT 

TCLINKLOAD 

DCLINKLOAD 

DSRTDEFIN 

LABEL1311 

SG4TD 

SG5TD 

DEFINE 

Note: The Linkage Loader expects that the first 
eight characters of the phase name will be "linkload." 
Any two characters may follow, making the format 
"linkloadxx." If this format is not followed, the Link- 
age Loader will not build any symbol tables. 
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Creation Charts 



The following charts show the Linkage Loader con- 
trol cards that can be used to construct the bbm pro- 
grams available within the system. 

These charts show some of the permissible con- 
figurations of the programs. They also indicate those 
configurations that will be constructed by specific 
Create packets. 

Note: Many of the modules contain imbedded 
calls. Because of this, a specific program may require 
modules not listed on the creation charts. 



Use of Creation Charts 

The following example illustrates the use of these 
charts. Refer to the Linkage Loader chart, which 
shows that a total of eight possible configurations of 



the Linkage Loader can be generated. The Go file, 
the sof (or sgf, during System Generation) and the 
library can each be on either tape or disk, giving a 
total of eight combinations. The user makes his selec- 
tion from the possibilities given at the top of the table. 
For example, if all files are to be on tape, the first 
column is the appropriate one. The user then has the 
choice of calling Create packet tijnkload or punching 
the appropriate cards as indicated at the lower por- 
tion of the table. 

Where a Create packet name is given for a selected 
configuration, the lower half of the table shows the 
exact contents of this package. If there is no name 
entered and if the appropriate configuration is desired, 
the user must supply the cards indicated (in the order 
shown). 



LINKAGE LOADER 






Go File on 


Tape 


X 


X 


X 


X 














Disk 










X 


X 


X 


X 






SOF on 


Tape 


X 


X 






X 


X 










Disk 






X 


X 






X 


X 






LIB on 


Tape 


X 




X 




X 




X 








Disk 




X 




X 




X 




X 






Create Packet Name 


TLINKLOAD 














DLINKLOAD 


TCLINKLOAD 


DCLINKLOAD 


16 21 






















PHASE LINKLOAD 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


CALL IBLNKPROC 


X 


X 


X 


X 


X 


X 


X 


X 


X 


X 


CALL IBLNKGOTAP 


X 


X 


X 


X 










X 


X 


CALL IBLNKGODSK 










X 


X 


X 


X 




CALL IBLNKINTAP 


X 




X 




X 




X 




X 




CALL IBLNKINDSK 




X 




X 




X 




X 




X 


CALLN IBLNKOUTAP 


X 


X 






X 


X 






X 




CALLN IBLNKOUDSK 






X 


X 






X 


X 




X 


CALL IBCOUPLE 






1 










X 


X 



NOTE: Create pockets TCLINKLOAD and DCLINKLOAD are for chained programs. 
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Monitor Modules in Relocatable Library 



REQUIRED 

IBACCOUNT 

IBAINQUIRY 

IBEXEQM 

IBIOARM 

IBPPCOMMON 

IBRDSIU 

IBREADMOCC 

IBSCANM 

IBMVERSION 

CONDITIONAL 

IBIOATM 

IBIOATMVAR 

IBPCHNONE 

IBPCHTP 

IBPCHUR 

IBPCHVAR 

IBPRTNONE 

IBPRTTP 

IBPRTUR 

IBPRTVAR 

IBLOOKM 

IBREADAIU 

IBPOWTRAN 

SNAPSHOT 

IBSPLNITER 



required: tape only 
IBBSPTP 
IBSEARCHT 
IBSLMTP 
IBTCCGM 
IBTNCGM 
IBTOCGM 
IBTPCGM 
IBZRRTP 
IBABTPM 



required: disk only 
IBDCCGM 
IBDNCGM 
IBDOCGM 
IBDPCGM 
IBSEARCHD 
IBSIMDK 
IBZRRDK 
IBABDKM 



(Transitional Monitor Input/Output Assign- 
ment) 

(Transitional Monitor Input/Output Assign- 
ment Variable ) 
(No Standard Punch Unit) 
(SPU is tape) 

(SPU is 1402 Card Read Punch) 
( Variable Punch ) 
(No Standard Print Unit) 
(SPR is tape) 
(SPR is 1403 Printer) 
(Variable Prjnt) 
( Required by Utility programs ) 
( System includes Alternate Input Unit ) 
(POW required for tape SPR and/or SPU) 
(Required for Snapshot capability) 
(Required for SPOOL capability) 



SYSTEM MONITOR 


SOFon 


Tape 


X 






Disk 




X 




Create Packet Name 


TMONITOR 


DMONITOR 


TTRANSIT 


16 21 
PHASE IBSGDL 
" CALL SGDLBOOT 




X 
X 




PHASE 
** CALL IBDLIO 
** CALLN IBSGDLDR 




X 
X 
X 




PHASE IBBOOT 
CALL IBBOOTIT 
* CALL IBBOOT2D 


X 
X 


X 
X 




PHASE 
* CALL IBBOOT2T 


X 
X 


X 




PHASE IBRESMON 
PRTCT 00000 
* CALLN IBRESIOCS 
CALLN IBRESIDENT 
CALLN IBMENDM 


X 
X 
X 
X 
X 


X 
X 
X 
X 




PHASE 

PHASE IBTRANSIT 

CALLN IBTRANSIT 


X 
X 


X 
X 


X 


61 
*** PHASE 1 
DISGO 
PRTCT 


X 
X 
X 


X 
X 
X 


X 



* These modules are produced by 
the System Generation macros. 
** This module is contained In the Relocatable Library. 
*** To Insert Directory 1. 



RESTART PROGRAM * 


Create Packet Name 


RESTART 




16 21 






CONGO 


X 




PRTCT 00000 


X 




PHASE RESTART 


X 


** 


CALL IBRSTMOD1 


X 




PHASE 


X 


** 


CALL IBRSTMOD2 


X 




PHASE 


X 


** 


CALLN IBRSTMOD3 


X 




DISGO 


X 




PRTCT 


X 



* If used, the CREATRESTART card must immediately follow 
the CREATTMONITOR or CREATDMONITOR card. 
** This module is generated with the Resident IOCS. 
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MONITOR 
(For Tele-Processing System) 


SOF On 


Tape 


X 


X 






Disk 






X 


X 


Create Packet Name 


TMONTP1 


TMONTP2 


DMONTP1 


DMONTP2 


16 21 

PHASE IBSGDL 

CALL SGDLBOOT 

PHASE 

CALL IBDLIO 

CALLN IBSGDLDR 






X 
X 
X 
X 
X 




PHASE IBBOOT 
CALL IBBOOT1T 
CALL IBBOOT2D 


X 
X 




X 
X 




PHASE 

CALL IBBOOT2T 


X 
X 




X 




PHASE IBRESMON 
PRTCT 00000 
CALLN IBRESIOCS 
CALLN PRESIDENT 
CALLN IBRESIDEN2 
CALLN IBMENDM 


X 
X 
X 


X 
X 
X 


X 
X 


X 
X 
X 


PHASE 

PHASE IBTRANSIT 

CALLN IBTRANSIT 




X 
X 




X 
X 


61 
PHASE 1 
DISGO 
PRTCT 




X 
X 
X 




X 
X 
X 



AUXILIARY LINKAGE LOADERS* 




DISK TP LIBRARY 


TAPE TP DISK 


SOF on Tape 


X 




X 




X 




SOF on Disk 




X 




X 




X 


Relocatable Library and 
Go File on Tape 


X 




X 




X 




Relocatable Library and 
Go File on Disk 




X 




X 




X 


Output on Tape 








X 


X 


X 


Output on Disk 


X 


X 


X 








Create Packet Name 


LINKLOADTD 


LINKLOADRD 




LINKLOADDT 


LINKLOADRT 




16 21 
PHASE LINKLOADTD 
PHASE LINKLOADDT 
PHASE LINKLOADRT 
PHASE LINKLOADRD 
CALL IBLNKPROC 
CALL IBLNKGOTAP 
CALL IBLNKGODSK 
CALL IBLNKINTAP 
CALL IBLNKINDSK 
CALLN IBLNKOUTAP 
CALLN IBLNKOUDSK 
CALLN TPLIBGENXT 
CALLN TPLIBGENXD 


X 

X 
X 

X 
X 


X 
X 

X 

X 

X 


X 
X 
X 

X 
X 


X 

X 

X 

X 
X 


X 

X 
X 

X 
X 


X 
X 
X 
X 

X 



'LINKLOADTD and LINKLOADDT are for use in Tele-processing systems that store the TP Library file in a storage medium different 
from that used for the SOF and Job file (disk TP library in a tape-oriented system, or tope TP library in a disk-oriented system). The 
remaining four configurations are the one-pass TP Relocatable Library generators. 
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COBOL 


C^irt PiIa m 


Tape 


X 


X 






^^v r 1 10 mi 


Disk 






X 


X 


Work Files on 


Tope 


X 




X 




Disk 




X 




X 


Create Packer Name 


TCOBOL 






DCOBOL 


6 16 21 










001 PHASE COBOL 


X 


X 


X 


X 


CALL IBTNCGM 


X 


X 






CALL IBDNCGM 






X 


X 


CALLN IBCBLCSP01 


X 


X 


X 


X 


CALL IBCBLCSP09 


X 


X 


X 


X 


CALLN IBCBLCSP02 


X 


X 


X 


X 


CALL IBCBLCSP03 


X 


X 


X 


X 


CALLN IBTOCGM 


X 


X 






CALLN IBDOCGM 






X 


X 


CALL IBCBLP0MF1 


X 


X 


X 


X 


010 PHASE 


X 


X 


X 


X 


BASE1 IBTOCGM 


X 


X 






BASE1 IBDOCGM 






X 


X 


CALL IBTPCGM 


X 


X 






CALL IBDPCGM 






X 


X 


CALLN IBCBLCST04 


X 




X 




CALLN IBCBLCSD04 




X 




X 


CALL IBCBLCST05 


X 




X 




CALL IBCBLCSD05 




X 




X 


CALLN IBCBLP1MF1 


X 


X 


X 


X 


015 PHASE 


X 


X 


X 


X 


PRTCT IBCBLP1MF1 


X 


X 


X 


X 


BASE1 IBCBLP1MF1 


X 


X 


X 


X 


CALL IBCBLP1MF2 


X 


X 


X 


X 


020 PHASE 


X 


X 


X 


X 


BASE1 IBCBLP1MF2 


X 


X 


X 


X 


CALL IBCBLCST06 


X 




X 




CALL IBCBLCSD06 




X 




X 


CALLN IBCBLP1MF3 


X 


X 


X 


X 


025 PHASE 


X 


X 


X 


X 


PRTa 


X 


X 


X 


X 


BASE1 IBCBLCST04 


X 




X 




BASE) IBCBLCSD04 




X 




X 


CALL IBCBLCST07 


X 




X 




CALL IBCBLCSD07 




X 




X 


CALLN IBCBLP2MF1 


X 


X 


X 


X 


030 PHASE 


X 


X 


X 


X 


BASE1 IBCBLCSP02 


X 


X 


X 


X 


CALL IBCBLCST04 


X 




X 




CALL IBCBLCSD04 




X 




X 


CALLN IBCBLCST06 


X 




X 




CALLN IBCBLCSD06 




X 




X 


CALL IBCBLCST07 


X 




X 




CALL IBCBLCSD07 




X 




X 


CALLN IBCBLCSP08 


X 


X 


X 


X 


035 PHASE 


X 


X 


X 


X 


CALL IBCBLP2MF2 


X 


X 


X 


X 


040 PHASE 


X 


X 


X 


X 


BASE1 IBCBLP2MF2 


X 


X 


X 


X 


CALL IBCBLP2MF3 


X 


X 


X 


X 


045 PHASE 


X 


X 


X 


X 


BASE1 IBCBLP2MF3 


X 


X 


X 


X 


CALL IBCBLP2MF4 


X 


X 


X 


X 


050 PHASE 


X 


X 


X 


X 


BASE1 OLEE/ 


X 


X 


X 


X 


CALL IBTPCGM 


X 


X 






CALL IBDPCGM 






X 


X 


CALLN IBCBLP3MF1 


X 


X 


X 


X 


CALL IBCBLP3T01 


X 




X 




CALL IBCBLP3D01 




X 




X 


055 PHASE 


X 


X 


X 


X 


BASE) IBCBLP3MF1 


X 


X 


X 


X 


CALL IBCBLCSP03 


X 


X 


X 


X 


CALLN IBCBLCST07 


X 




X 




CALLN IBCBLCSD07 




X 




X 


CALL IBCBLCSP08 


X 


X 


X 


X 


CALLN IBTCCGM 


X 


X 






CALLN IBDCCGM 






X 


X 


CALL IBCBLP4MF1 


X 


X 


X 


X 


060 PHASE 


X 


X 


X 


X 


CALL IBCBLP5MF1 


X 


X 


X 


X 



60 



AUTOCODER 


Work Files and 
Go Piles on 


Tape 


X 


X 






Disk 






X 


X 


Processor 
Resides on 


Tape 


X 




X 




Disk 




X 




X 


Create Packet Nome 


TAUTOCODE 






DAUTOCODE 


6 16 21 

001 PHASE AUTOCODER 
CALL IBAU10COMM 
CALLN IBAU10INPT 
CALL IBAU10TPE1 
CALL IBAU10TPE2 
CALL IBAU10DSK1 
CALL IBAU10DSK2 
CALL IBAU10DSK3 
CALL IBAU10IOTB 


X 
X 
X 
X 
X 

X 


X 
X 
X 
X 

X 
X 


X 
X 
X 

X 

X 
X 


X 
X 
X 

X 
X 

X 


61 
* 010 PHASE 3 

62 
** 015 PHASE M 


X 
X 


X 


X 
X 


X 


020 PHASE 

CALLN IBAU20GENR 
CALL IBAU20TPE1 
CALL IBAU20TPE2 
CALL IBAU20DSK1 
CALL IBAU20DSK2 
CALL IBAU20DSK3 


X 
X 
X 
X 


X 
X 
X 

X 


X 
X 

X 
X 


X 
X 

X 
X 


030 PHASE 

CALLN IBAU30ASGN 
CALL IBAU30SCAN 
CALL IBAU30TPE1 
CALL IBAU30DSK1 
CALLN IBAU30SUBR 


X 
X 
X 
X 

X 


X 
X 
X 
X 

X 


X 
X 
X 

X 
X 


X 
X 
X 

X 
X 


033 PHASE 

CALLN IBAU33SUBR 
CALL IBAU33TPE1 
CALL IBAU33DSK1 
CALLN IBAU33.RCUR 


X 
X 
X 

X 


X 
X 
X 

X 


X 
X 

X 
X 


X 
X 

X 
X 


040 PHASE 

CALLN IBAU40OTPT 
CALL IBTOCGM 
CALL IBDOCGM 
CALL IBTPCGM 
CALL IBDPCGM 
CALL IBTCCGM 
CALL IBDCCGM 
CALL IBTNCGM 
CALL IBDNCGM 
CALLN IBAU40TPE1 
CALLN IBAU40DSK1 


X 
X 
X 

X 

X 

X 

X 


X 
X 
X 

X 

X 

X 

X 


X 
X 

X 

X 

X 

X 

X 


X 
X 

X 

X 

X 

X 

X 


050 PHASE 

CALL IBAU50TPE1 
CALL IBAU50DSK1 
CALLN IBAU50CREF 


X 
X 

X 


X 
X 

X 


X 

X 
X 


X 

X 
X 



To insert Directory 3 

To insert the Macro Library 



COBOL: Relocatable Library Modules for Object 
Programs 

The following modules are required by cobol object 
programs: 

IBCOBOL 

IBCBLADOVR 

IBCBLDSPLY 



IBCBLCMPAR 

IBCBLFLDMP 

IBCBLALTST 

IBCBLSUBSC 

IBCBLACCPT 

IBCBLEXPON 

IBCBLRDINT 

IBCBLDVZER 

IBCBLCLEAR 
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FORTRAN: Relocatable Library Modules for Object 
Programs 

Required Modules 

The following modules are required to run with any 
Fortran object program: 



IBCOMMON 


IBINDX2 


IBBACKSP 


EXP 


IBLABEL 


IBINDX3 


IBENDFILE 


ALOG 


IBFOERR 


IBEXPFF 


IBREWIND 




IBINTRP 


IBEXPFI 


FLOAT 




IBINDX1 


IBEXPII 


IFIX 





Optional Modules 

The following modules are not required by a Fortran 
program unless they are called by name in the source 
program. Inclusion of these modules is therefore an 
installation option, except (as noted) the selection 
of one optional module may require another. 



ABS 




DIM 


AINT 




DVCHK 


AMAXO 




EXIT 


AMAX1 




IABS 


AMINO 




IDIM 


AMIN1 




INT 


AMOD (requires AINT) 


ISIGN 


ATAN 




MAXO 


COS (requires 


SIN) 


MAX1 



MINO 

MINI 

MOD 

OVERFL 

SIGN 



SIN 

SLITE (requires SLITET) 

SLITET 

SQRT 



Floating-Point Arithmetic Modules 

The four modules supporting floating-point arithmetic 
are on the Relocatable Library of the Master file in 
the following order: 



NAME 



IBINTRP 

OVERFL 

DVCHK 

IBINTRP 



REMAKES 

For programmed interpretation of 
floating-point instructions. 
For machine interpretation of 
floating-point instructions ( on an 
IBM 7010 with the Floating-Point 
Arithmetic feature). 

To obtain the modules supporting the 7010 Float- 
ing-Point Arithmetic feature, the following card should 
be used: 

6 16 21 

IBINTRP DELET R 

To obtain the modules that provide programmed 
interpretation for floating-point instructions, use this 
card: 

6 16 21 

OVERFL DELET R.IBINTRP 



FORTRAN 


Work Files on 


Tape 


X 


X 






Disk 






X 


X 


Go File on 


Tape 


X 




X 




Disk 




X 




X 


Create Packer Name 


TFORTRAN 






DFORTRAN 


16 21 










PHASE FORTRAN 


X 


X 


X 


X 


CALLN IBFTNCMN 


X 


X 


X 


X 


CALL IBFTN05TO 


X 


X 






CALL IBFTN05DO 






X 


X 


CALLN IBFTN05 


X 


X 


X 


X 


PHASE 


X 


X 


X 


X 


BASE1 FCMN/ 


X 


X 


X 


X 


CALL IBTPCGM 


X 




X 




CALL IBDPCGM 




X 




X 


CALL IBTCCGM 


X 




X 




CALL IBDCCGM 




X 




X 


CALL IBTNCGM 


X 




X 




CALL IBDNCGM 




X 




X 


CALLN IBTOCGM 


X 




X 




CALLN IBDOCGM 




X 




X 


CALL IBFTN10TO 


X 


X 






CALL IBFTN10DO 






X 


X 


CALL IBFTN10TI 


X 


X 






CALL IBFTN10OI 






X 


X 


CALLN IBFTN10 


X 


X 


X 


X 


PHASE 


X 


X 


X 


X 


BASE1 MOCG/ 


X 


X 


X 


X 


CALL IBFTN20TO 


X 


X 






CALL IBFTN20DO 






X 


X 


CALL IBFTN20TI 


X 


X 






CALL IBFTN20DI 






X 


X 


CALLN IBFTN20 


X 


X 


X 


X 


PHASE 


X 


X 


X 


X 


BASE1 MOCG/ 


X 


X 


X 


X 


CALL IBFTN25TI 


X 


X 






CALL IBFTN25DI 






X 


X 


CALLN IBFTN25 


X 


X 


X 


X 
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Generalized Tape Sorting Program: Relocatable 
Library Modules 

To create any tape sort program, all of the following 
modules must appear in a Relocatable Library and 
should be in the order given. Module rBSRTEQASN must 
be included twice, as shown. 



IBSRTCOMAN 

IBSRTPRIME 

IBSRTCTLCD 

IBSRTGASSR 

IBSRTGASM3 

IBSRTDUMOO 

IBSRTEQUAL 

IBSRTIO101 

IBSRTIO102 

IBSRTIO104 

IBSRTIO105 

IBSRTREPLT 

IBSRTREPLQ 

IBSRTIO103 

IBSRTIO106 

IBSRTP1ASN 

IBSRTDUM01 

IBSRTEQASN 

IBSRTIO109 

IBSRTIO110 

IBSRTIO107 

IBSRTIO108 

IBSRTIO203 

IBSRTIO201 

IBSRTMNTS2 

IBSRTMNTM2 

IBSRTRPPH2 

IBSRTIO205 



IBSRTIO206 

IBSRTDUM02 

IBSRTAMRG2 

IBSRTIO204 

IBSRTIO202 

IBSRTI0314 

IBSRTIO301 

IBSRTIO302 

IBSRTIO305 

IBSRTIO306 

IBSRTI0399 

IBSRTMNTM3 

IBSRTMNTS3 

IBSRTRMRG3 

IBSRTLKAD3 

IBSRTIO303 

IBSRTIO304 

IBSRTSQTG3 

IBSRTDUM03 

IBSRTEQASN 

IBSRTSUPH3 

IBSRTAMRG3 

IBSRTIO307 

IBSRTIO308 

IBSRTIO310 

IBSRTI0311 

IBSRTI0312 

IBSRTIO309 



TAPE SORT DEFINITION PROGRAM 


Create Pocket Name 


TSRTDEFIN 


16 21 

PHASE SORTDEFINE 

CALL IBSRTDEFIN 


X 
X 



Generalized Sorting Program Using IBM 1301/2302 
Disk Storage: Relocatable Library Modules 

To create any disk sort program, all of the following 
modules must appear in a Relocatable Library and 
should be in the order given. 



IBDSRTCOMN 

IBDSRTPTTP 

IBDSRTPRIM 

IBDSRTGA01 

IBDSRTGA02 

IBDSRTGADM 

IBDSRTEQAL 

IBDSRTRPP1 

IBDSRTOCF1 

IBDSRTMCF1 

IBDSRTIOJ1 

IBDSRTIOK1 

IBDSRTIOL1 

IBDSRTIOM1 

IBDSRTAP21 

IBDSRTDUM1 

IBDSRTEQAS 

IBDSRTAP11 

IBDSRTIOA1 

IBDSRTIOC1 

IBDSRTIOE1 

IBDSRTIOB1 

IBDSRTIOD1 

IBDSRTIOF1 



IBDSRTOCF2 

IBDSRTMCF2 

IBDSRTRPP2 

IBDSRTAP12 

IBDSRTOCF3 

IBDSRTMCF3 

IBDSRTRP13 

IBDSRTRP23 

IBDSRTRP33 

IBDSRTRP43 

IBDSRTRP53 

IBDSRTRP63 

IBDSRTRP73 

IBDSRTRP83 

IBDSRTRP93 

IBDSRTIOR1 

IBDSRTHS13 

IBDSRTDUM3 

IBDSRTAP13 

IBDSRTAP23 

IBDSRTAP33 

IBDSRTAP43 

IBDSRTAP53 



DISK SORT DEFINITION PROGRAM 


Create Packet Name 


DSRTDEFIN 


16 21 

PHASE DSRTDEFINE 

CALLN IBDfSRTDEF 


X 
X 



UTILITY PROGRAMS* 


Storage Print 


X 


X 


X 


X 


X 






Tape Print 




X 


X 




X 


X 




Disk Print (1301, 2302, 1311) 


X 


X 


X 


X 




X 


X 


1301 Disk Format/ Address Generator 






X 


X 






X 


2302 Disk Format/Address Generator 






X 


X 






X 


1311 Format/Address Generator 


X 


X 


X 










File Save 






X 


X 






X 


File Restore 






X 


X 






X 


Data File Generator 






X 


X 








Create Packet Name 






UTILITIES 










001 PHASE UTILITIES 
CALLN IBLOOKM 
CALL IBUTILITY 

002 PHASE 

CALL IBUTILSCAN 

003 PHASE 

CALL IBTAPEDUMP 

004 PHASE 

CALL IBDISKDUMP 

005 PHASE 

CALLN IBCOREDCTL 
CALL IBCOREDUMP 

006 PHASE 

CALLN IBOIFAGEN 
CALL IBADDRESR 

007 PHASE 

CALL IBllADRGEN 

008 PHASE 

CALL IBFILESAVE 

009 PHASE 

CALL IBFILEREST 

010 PHASE 

CALLN IB02FAGEN 
CALL IBADDRESR 
016 PHASE 
. -., CALL IBFH.EGEN 


X 
X 
X 
X 
X 

X 
X 
X 
X 
X 

X 
X 


X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 

X 
X 


X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 
X 


X 
X 
X 
X 
X 

X 
X 
X 
X 
X 
X 
X 
X 

X 
X 
X 
X 
X 
X 
X 
X 
X- 


X 
X 
X 
X 
X 
X 
X 

X 
X 
X 


X 
X 
X 
X 
X 
X 
X 
X 
X 


X 
X 
X 
X 
X 

X 
X 

X 
X 
X 

X 
X 
X 
X 
X 
X 
X 



*The Snapshot Program, if selected, is generated as part of the System Monitor or part of a dependent program . 
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SGI PROGRAM 


SGFor 
SOF on 


Tape 


X 




Disk 




X 


Create Pocket Name 


TSYSGEN1 


DSYSGEN1 


16 21 
PHASE SGI 
CALL IBSYSGENl 
CALL IBDSYSGENl 

61 
* PHASE 1 


X 
X 

X 


X 
X 



* To insert Directory 1 . 



SG2 PROGRAM 


SGFor 
SOF on 


Tape 


X 




Disk 




X 


Create Packet Name 


TSYSGEN2 


DSYSGEN2 


16 21 

PHASE SG2 

CALL IBSYSGEN2 

CALL IBDSYSGEN2 

PHASE 

CALL IBDSYSGEN3 


X 
X 


X 

X 
X 
X 



SG3 PROGRAM 


Create Packet Name 


SYSGEN3 


16 21 
PHASE SG3 
CALL IBUPPER 


X 
X 



MACRO PRINT and PUNCH PROGRAM 


Macro Library on 


Tape 


X 




Disk 




X 


Create Packet Name 


TMACROPRT 


DMACROPRT 


16 21 

PHASE MACROPRT 

* CALL IBPRINTMT 

* CALL IBPRINTMD 


X 
X 


X 
X 



'Contains an imbedded call for module IBPRINTM. 



DISK LIBRARY LOADER 


Create Packet Name 


DSKLIBLDR 


16 21 

PHASE DSKLIBLDR 

CALL IBSGLDLDR 


X 
X 



SYSTEM DEFINITION PROGRAM (FILE ORGANIZATION SYSTEM) 


Create Packet Name 


DEFINE 


16 21 
PHASE DEFINE 
CALL IBFOSYSDEF 


X 
X 



MASTER TAPE LOAD PROGRAM* 



Create Packet Name 



16 

PHASE 

CALL 

PHASE 

CALL 

CALLN 



21 

IBSGDL 

SGDLBOOT 

IBDLIO 
IBSGDLDR 



'If a disk SOF (or SGF) is to have regenerative ability, 
this program must be the last program on the file. 



1311 LABEL PROGRAM 


Create Packet Name 


LABEL1311 


16 21 

PHASE LABEL1311 

CALL IB1311LBL1 


X 
X 



SG4 PROGRAM 


Create Packet Name 


SG4TD 


16 21 
PHASE SG4 
CALL IBSG4 


X 
X 



IBSGDL 



COMPLETE SYSTEMS 


SOF is on 


Tape 


X 




Disk 




X 




Create Packet Name 


TSYSTEM 


DSYSTEM 




TMONITOR 


X 






DMONITOR 




X 




TCLINKLOAD 


X 






DCLINKLOAD 62 




X 




PHASE IBMLIBR R 


X 






TTRANSIT 


X 






TSYSGEN2 


X 






DSYSGEN2 




X 




SG5TD 


X 


X 




TTRANSIT 


X 






TAUTOCODE 


X 






DAUTOCODE 




X 




TTRANSIT 


X 






TSYSGEN1 


X 






DSYSGEN1 62 




X 




PHASE CREATLIB C 


X 






TTRANSIT 


X 






TSRTDEFIN 


X 


X 




TTRANSIT 


X 






TCOBOL 


X 






DCOBOL 




X 




TTRANSIT 


X 






TFORTRAN 


X 






DFORTRAN 




X 




TTRANSIT 


X 






UTILITIES 


X 


X 




TMACROPRT 


X 






LABEL1311 




X 




DMACROPRT 




X 




TTRANSIT 


X 






SYSGEN3 


X 


X 




DSRTDEFIN 


X 


X 




TTRANSIT 


X 






DSKLIBLDR 




X 




IBSGDL (must be last) 




X 



SG5 PROGRAM 


Create Packet Name 


SG5TD 


16 21 




PHASE SG5 


X 


CALL IBSG5 


X 


PHASE 


X 


CALL IBSG5D 


X 


PHASE 


X 


CALL IBSG5T 


X 


PHASE 


X 


CALL IBSG5E 


X 
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Examples of System Generation for a Tape System 



This section illustrates a series of interrelated System 
Generation jobs for a tape-oriented system. Setup re- 
quirements for the tape units are given for each ex- 
ample. The setup information relates Table 1 ("Basic 
Concepts ■— Tape-Oriented System") of this publica- 
tion and the asgn cards required by the specific 
example. 

Using the IBM-supplied Master file, the successive 
examples are: 

Example 1 — Generation of sgf 
Example 2 — Generation of modified sgf 
Example 3 — Generation of Autocoder/FORTRAN 

SOF 

Example 1 

Figure 20 illustrates the generation of an sgf from the 
Master file. The user's installation is assumed to in- 
clude a machine of the following configuration. 

System: IBM 1410 with two input/output channels and 

80,000 positions of core storage. 

No Tele-processing 

No disk storage 
Channel 1: 1402 Card Read Punch 

1403 Printer 

Six 729 tape units 
Channel 2: Six 729 tape units 

Note: oteatttransit card(s) may be added to 
give additional copy(ies) of Transitional Monitor at 
the time Monitor is generated. 

Contents of New Resident Monitor 

System description control cards define a new System 
Monitor as follows. 

GEN01 defines: 

Printer, reader, and punch on channel 1 
GEN02 defines: 

Core Image file 

Six tape units on channel 1 ( A0-A5 ) 

Six tape units on channel 2 ( B0-B5 ) 
GEN08 defines: 

IBM 1410 System 

80,000 positions of core storage 

Core Image file 

Unit-record printer 

Unit-record punch 
Alternate input routine (AIU) 

55 to be entered in Communication Region, /LIN/ 

Ten-character console input area 

Type and print Monitor control cards 

SOF assigned to A0 

SIU assigned to Rl 

SPR assigned to PI 

SPU assigned to XI 

MDM assigned to B4 

Memory print Snapshot at unusual end of program 



GEN09 defines: 

5 Monitor Reserve files (MR0-MR4) 
GEN10 defines: 

5 Monitor work files (MW0-MW4) 

MW1 assigned to B0 

MW2 assigned to Al 

MW3 assigned to Bl 
GENU defines: 

No TP files 
DEVDF defines: 

729 tape units on channel 1 

1402 Card Read Punch on channel 1 

1403 Printer on channel 1 
729 tape units on channel 2 

IOKDF defines: 
IBM 1410 System 
Error statistics to be taken 
/OGR/ at 70000 

The following points are illustrated by this example. 

1. The Sort Definition program and one configura- 
tion of the Utility program are generated in addition 
to those that were on the Master file. The Create Li- 
brary packet for the Utility program is not used in 
order to show how the Linkage Loader control cards 
are placed. Also, since there is no disk storage, the 
Disk Print Utility is omitted. 

2. The "L" in card column 58 of the exeq sgs card 
indicates that the largest size records are to be built. 



MONSS 


DATE YROAY 














MONSS 


JOB SAMPLE NO.l 


TC 


1 GENERATE AN INSTALLATION 


SGF 


MONSS 


ASGN MJB.A1 














MONSS 


ASGN MW3.A1 














MONSS 


ASGN MW1.A2 














MONSS 


ASGN MW2.B1 














MONSS 


ASGN MG0.B2 














MONSS 


ASGN MR0.B2 














MONSS 


MODE GO.SG 














MONSS 


EXEQ AUTOCODER. SOF, 


SIU.NOFLG.NOPCH 










HEADRSAMPLE NO.l 
















GEN01P1.R1.X1 
















GEN02/MDM/.1 ,AO, 


Al, 


A2.A3, 


.A4.A5 










GEN02/MDM/,2,B0. 


Bl, 


B2.B3, 


,S4,B5 










GEN081700090119, 


,55 


,10,099,A0.R1,, 


• PI, 


XI... B4 


■ .SNAP 




GEN095 
















GEN105..BO.A1.B1 
















GENU 
















DEVOF1. 729, 1*02, 


1403 












DEVDF2.729 
















[OKOF1410.,,4, . , 




70000 












END 














MONSS 


EXEQ SGI 

LOCATC.CREATLtB 

INSERC 

LOCATR.IBMLIBR 

[NSERR 

LOCATM. AUTOCODER 

INSERM 

END 

CREATTMONITOR 

CREATT AUTOCODE 

CREATTSYSGEN1 

PHASECREATLIB 

CREATTSRTOEFIN 

CREATTLINKLOAD 

PHASEIBMLISR 

CREATTSYSGEN2 










7 


C 
R 


001 


PHASEUTILITIES 
CALL IBUTILITY 














002 


PHASE 

CALL IBUTILSCAN 














003 


PHASE 

CALL IBTAPEDUMP 














005 


PHASE 

CALLNIBCOREDCTL 
CALL IBCOREDUMP 
END 














MONSS 


EXEO LINKLOAD 
INPUTM*2 














MONSS 


EXEQ SG2 










L7 




MONSS 


END 














Figure 20, 


Control Cards 


to 


i Generate an 


SGF 


from 


the 




Master File 
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Setup Instructions 

Setup instructions for this example are: 

1. Mount Master file on AO. 

2. Mount scratch tapes on Al, A2, Bli B2. 

3. The output tape will be on MW2. 

Example 2 

Figure 21 illustrates the modification of the sgf cre- 
ated in Example 1. 

The following points are illustrated by this ex- 
ample. 

1. The Monitor from Example 1 is copied onto the 
new file. 

2. A two-phase user program (userprog) is added. 
The first phase comprises subprogi and subprog2. The 
second phase consists of subprog3. The relocatable sub- 
programs are added to ibmlibr after compilation. The 
appropriate Linkage Loader control cards have been 
combined into a package and added to creatlib. 



userprog is put into the operating section of the modi- 
fied SGF. 

3. sgi and sg2 cards no longer require machine size 
indicators. 

4. The "L" in card column 58 of the exeq sg2 card 
indicates that userprog is to be built in largest size 
records. The other programs are already in largest 
size. 

5. Multiple copies of the Transitional Monitor (ib- 
transit) are added to reduce search time during 
future operations. 

6. mwi, mw2, and MW3 are assigned within Moni- 
tor; therefore, no asgn cards are needed for them. See 
genio, in Example 1. 

Setup Instructions 

Setup instructions for this example are: 

1. Mount the sgf on AO. 

2. Mount scratch tapes on Al, BO, Bl, B2. 

3. The output tape will be on mw2. 



6 


16 21 


MON** 


DATE YRDAY 


MONSS 


JOB SAMPLE NO. 2 SGF WITH USER PROGRAM ANO IBTRANSITS 


MONSS 


ASGN MJB.B1 


MONS* 


ASGN MGO.B2 


MON*$ 


ASGN MRO.B2 


MONSS 


MODE GO.SG 


MONSS 


EXEO AUTOCODER 




SOURCE DECK FOR SUBPROGRAM NO.l 




SOURCE DECK FOR SUBPROGRAM NO. 2 




SOURCE DECK FOR SUBPROGRAM NO. 3 


MONSS 


EXEO SGI 




LOCATC CREATLIB 


USERPROG 


INSERC 




GENERUSERPROG 




PHASEUSERPROG 




CALL SUBPROGI 




CALL SUBPR0G2 




PHASE 




BASE1SUBPROG2 




CALL SUBPR0G3 




LOCATR. IBMLIBR 


SUBPROGI 


INSERR 


SUBPROG2 


INSERR 


SUBPR0G3 


INSERR 




LOCATM. AUTOCODER 




INSERM 




END 




INCLDIBBOOT 




INCLDIBRESMON 




INCLDIBTRANSIT 




INCLOAUTOCODER 




INCLDIBTRANSIT 




END 


MONSS 


EXEQ LINKLOAD 




PHASE-USERPROG 




CALL SUBPROGI 




CALL SUBPROG2 




PHASE 




BASEISUBPR0G2 




CALL SUBPROG3 


MONSS 


EXEO SGI 




INCLDIBTRANSIT 




INCLDSGl 




INCLOCREATLIB 




INCLOIBTRANSIT 




INCLDLINKLOAD 




I NCLO IBMLIBR 




INCLDSG2 




INCLDIBTRANSIT 




END 


MONSS 


EXEQ SG2 L 


MONSS 


END 



Figure 21. Control Cards to Modify the sgf Created by the Cards of the Preceding Figure 



Example 3 

Figure 22 illustrates the creation of an sof, designed 
for efficient Fortran and Autocoder compile-and-go 
operation, from the file created in Example 2. 
The following points are illustrated by this example. 

1. The Go file (mgo) is not required in this job. 

2. The tjbmlibr is stripped to retain only those sub- 
programs required for Fortran and Snapshot. 

3. The Macro Library is stripped to retain only 
those Autocoder macro routines used by dependent 
programs. The Monitor-generation macro routines are 
deleted. 



4. The creatltb is not referenced; therefore, it is not 
included. 

5. Fortran is generated from ibmlibr. 

6. userprog is included. 

7. The file is sequenced for efficiency. 

Setup Instructions 

Setup instructions for this example are: 

1. Mount the modified sgf (output from Example 2) 
on AO. 

2. Mount scratch tapes on Al, BO, B2, B3. 

3. The output tape will be on MW2. 



21 



MONSS 


OATE YROAY 




MONSS 


JOB SAMPLE NO. 3 SOF WITH AUTOCODER AND FORTRAN 


MONSS 


ASGN MW1 ,BO 




MONSS 


ASGN MW2.BI 




MONSS 


ASGN MJB.B2 




MONSS 


ASGN MR0.83 




MONSS 


MODE SG 




MONSS 


EXEQ SGI 
LOCATR, IBMLIBR 




IBSRTCOMANDELETR. IBCBLCLEAR 




IBRANOOM 


DELETR.TPLIBGENXP 
LOCATM.AUTOCOOER 




GEN01 


DELETM 




GEN02 


DELETM 




GEN03 


DELETM 




GEN04 


DELETM 




GEN05 


DELETM 




GEN06 


DELETM 




GEN07 


DELETM 




GEN08 


DELETM 




GEN09 


DELETM 




GEN10 


DELETM 




GEN1 1 


DELETM 




DEVDF 


DELETM 




IOKDF 


DELETM 




GENRM 


DELETM 




DUMP 


DELETM 




ENDLD 


DELETM 




LDPTC 


DELETM 




TPDIR 


DELETM 

END 

INCLDIBBOOT 

INCLDIBRESMON 

INCLDIBTRANSIT 

INCLDAUTOCODER 

CREATTFORTRAN 

END 




MONSS 


EXEQ LINKLOAD 
INPUTMW2 




MONSS 


EXEQ SGI 

INCLDIBTRANSIT 

INCLDLINKLOAD 

INCLDIBMLIBR 

INCLDIBTRANSIT 

INCLOUSERPROG 

INCLDIBTRANSIT 

END 




MONSS 


EXEQ SG2 


L 


MONSS 


END 





Figure 22. Control Cards to Create a Fortran/ Autocoder 
sof from the Output File of the Preceding Figure 



Examples of System Generation for a Tape System 67 



Disk Load Programs 



This section explains: (1) the use of Disk Load pro- 
gram for loading the entire system, and (2) the Disk 
Library Loader for loading separately produced re- 
locatable libraries. The Disk Load program operates 
outside the system and requires separate setup and 
operating procedures. The Disk Library Loader 
(dsklibldr) operates within the system as a normal 
job. 

Disk Load Program 

The Disk Load program loads the contents of the disk 
system source tape and library tape onto disk in the 
areas specified by the user. This is the first program 
that appears on the disk Master file. Three configura- 
tions can be loaded by the program: 

1. System tape and library tape physically the same 
reel. 

2. System tape only. 

3. System tape and library tape physically different 
reels. 

When both the system and a library are to be 
loaded onto disk, two logically separate files are cre- 
ated on the disk. 

Note: If specified, the Disk Load program formats 
the areas of the disk required to contain the system 
and the library. Formatting is in Load mode, with geo- 
metric record addressing and with 2,165 character rec- 
ords. Only the specified cylinders are formatted. If 
the file being loaded exceeds the number of cylinders 
specified, a rerun is required. (See description of 
message 21551 under "Console Messages," below, for 
information on how to specify formatting.) Format- 
ting of disk areas required for files (e.g., mgo and 
mjb) used during the System Generation process may 
be accomplished by using the 1301 or 2302 Format/ 
Address Generator utility program. 

Program Description 

During the loading of the system tape, two directories 
are created. Directory 1 is the program directory; 
Directory 3 is the macro directory. Both directories are 
in a form suitable for use by table lookup instructions. 
The argument of each table is the program or macro 
name being sought and the function of each table is 
the corresponding track address of the first record of 
the program or macro. Both tables contain a short 



entry to terminate lookup. Should a program or macro 
contain more than one record, the additional records 
are found in the records that follow sequentially. 

Multiphase programs are intraconnected by control 
data contained in the first 12 characters of the first 
record of each phase. The first four characters of this 
data are the track number of the previous phase of the 
program, if any. If there is no previous phase, this field 
contains blanks. 

The next four characters of the control data are the 
track number of the next phase of the program, if any. 
If there is no subsequent phase, this field contains 
blanks. The next three characters of the data are the 
phase number of the phase located in that record. The 
last character of the field is for special use; it is the 
directory number if that record should be a directory. 

Directory 1 may be more than one record. For this 
situation, the first record is linked to the next by a 
track number in the last four characters of the original 
record. 

The macro directory, Directory 3, is limited in size. 
The maximum number of macro names that can be 
contained in the disk macro directory is 238, and any 
excess is lost. In this case, a diagnostic message is 
issued. 

An additional directory is created as the first ele- 
ment of the Relocatable Library (a separate file). This 
directory is identical in format to Directory 1 and con- 
tains the names of the library subprograms. 

Program Restrictions 

The two program restrictions are: 

1. No two successive directory requests are per- 
mitted. 

2. The program is restricted to channels 1 and 2. 

Setup Instructions 

The system tape, or system tape with library if they 
are on the same physical reel, must always be placed 
on a channel 1 or channel 2 tape unit to run the pro- 
gram. (If the load tape button of the ibm 7010 is to 
be used, the reel must be mounted on unit 10. ) 

If the system tape and library tape are physically 
different reels, the library tape must be mounted on 
unit 10 or 20 for the ibm 1410. The system tape can be 
placed on any other channel 1 or channel 2 tape unit. 



For the ibm 7010, the system tape must be mounted on 
unit 10 and the library tape must be mounted on unit 
20. Refer to the Operator's Guide for detailed operat- 
ing instructions. 

Console Messages 

The console messages that follow are associated with 
the Disk Load program. Information should be pro- 
vided to the operator so that those messages requiring 
operator action can be handled efficiently. 

Disk load Program Console Messages 

21551 ENTER START RCD AND CYLS FOR FILE 

ACMTTTTH2zNN 
Description and Action: Enter in the indicated format 
the address from which file is to be started* and number 
of cylinders to be used. 

A Access 

C Channel 

M Module 

TTTTH2 Disk geometric record address. (H2 is 
identified as HR under "Organization 
of Data Files on Disk Storage.") 

z If z is 1 (for 1301) or 2 (for 2302), 

the Disk Load program will format 
the specified area, write H2 and re- 
cord addresses, and load the specified 
area. If z is blank, the Disk Load pro- 
gram will load the specified area. If 1 
is indicated in the format key, the 
specified area will be formatted in 
load mode with a two-character HA2, 
a six-character record address and a 
2,165 character data record. If 2 is 
indicated in the format key, the speci- 
fied area will be formatted in load 
mode with a two-character HA2, a 
six-character record address, a 2,165 
character data record, a second record 
address (one higher than the first), 
and a second 2,165 character data 
record. 

NN Number of cylinders to be used by 

file. 

"This address must agree with the start address indi- 
cated on the GEN03-GEN06 card when the system 
was created. 

21552 FILE XCDS CYL LGTH, PRESS START TO CONT. 
Description and Action: Cylinder length (NN) too small. 
If disk format permits, file can be continued by pressing 
START. 

11551 FILE START RCD XXXXXX, LAST RCD XXXXXX. 
Description and Action: Message informs operator of 
area that file occupies. Disk record addresses are of the 
form TTTTH2 as explained for message 21551. 

11553 MAC LIB OVFLO 

Description and Action: Macro library directory is full 
( 238 elements ) and succeeding macros are lost. 

BOOTSTRAPS 

. . . (card image) . . . 1410 BOOT 

. . . (card image) . . . 7010 BOOT 

Description and Action: Message shows card image of 
bootstrap required to load the first record from disk to 
core storage. Operator must keypunch appropriate card 
for his machine (IBM 1410 or 7010) and place card 



in SIU. See the publication Operator's Guide for com- 
plete procedure. 

01551 END JOB 

Description and Action: All operations are complete. 
System tape (and library tape, if any) has been loaded 
as specified by the character entered at location 00000 
or by the contents of the system file being loaded. 

21553 ( Same as message 21551 ) 

Description and Action: Same description and action as 
message 21551 except that this message pertains to the 
disk location desired for the Relocatable Library. 

21554 (Same as message 21552) 

Description and Action: Same as message 21552 except 
that this message 21554 pertains to the Relocatable 
Library. 

11552 (Same as message 11551) 

Description and Action: Same as message 11551 except 
that this message 11552 pertains to the Relocatable Li- 
brary. 

11554 INVALID FILE, NO DIR 1 REQUEST 
Description and Action: System will not operate without 
Directory 1 which was not requested by Linkage Loader 
card. 

11555 NO TAPE LABEL FOUND 

Description and Action: Library tape was indicated to 
have a tape label by word mark entered in 00000, but 
no label was found. 

11556 NO RLIB HEADER FOUND 

Description and Action: Tape designated as Relocatable 
Library by character entered in 00000 does not contain 
the Relocatable Library header. 

Note: The iocs may generate other messages due 
to seek checks, no record found, etc. These may be 
caused by operator error in making console entries, 
incorrect formats, or disk unit malfunctions. The oper- 
ator may cancel console inquiries in the event of error. 



Disk Library Loader (DSKLIBLDR) 

The Disk Library Loader loads the contents of a sepa- 
rate relocatable library tape onto the disk. This load 
program is a subprogram of the Master file. The li- 
brary tape to be loaded must be on symbolic unit 
mwi, and the disk area loaded is that which is as- 
signed as LIB. 

Program Description 

The first record of the file loaded on the disk is a di- 
rectory of library subprograms that is built as the file 
is loaded. A brief description applicable to this direc- 
tory is given earlier, under "Disk Load Program." The 
library tape is read in Move mode, and the disk is 
written in Load mode. 

Setup Instruction and Use of Program 

The relocatable library tape must be mounted on sym- 
bolic unit mwi. 
The following example shows how the Disk Library 



Disk Load Programs 



Loader is used to load a relocatable library tape into 
lib on disk storage. 



6 


16 


21 


MON$$ 


JOB 


LOAD SEPARATE RELOC 
LIBE 


MON$$ 


ASGN 


MW1.A5 


MON$$ 


ASGN 


LIB,D8 


MON$$ 


EXEQ 


DSKLIBLDR 


MON$$ 


END 





Console Messages 

The console messages that follow are associated with 
the Disk Library Loader. 



Disk Library Loader Console Messages 

91558 NO RLIB HEADER FOUND 

Description and Action: Neither of the first two tape 
records was a relocatable library header. Control is re- 
turned to Monitor with NOGO switch turned on. 

91556 RLIB XCDS DISK AREA 

Description and Action: The Relocatable Library is too 
large to be loaded in the disk area assigned as LIB. 
Control is returned to Monitor with the NOGO switch 
turned on. 

11557 RLIB START RCD XXXXXX, LAST RCD XXXXXX 
Description and Action: Informs operator of disk area 
which relocatable library occupies. Disk record addresses 
are of the form TTTTH2 as explained for message 
21551, "Disk Load Program." 
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SGI and SG2 Diagnostic Messages 



The sgi and sgs diagnostic messages are listed in this 
section with an explanation of the message and sug- 
gested corrective action for: (1) tape-oriented systems, 
and (2) disk-oriented systems. 



Tape-Oriented System 

Diagnostic messages that may be produced on the con- 
sole printer during execution of sgi and SG2 are listed 
in sequence by message number in the following sec- 
tion. When one of these messages appears, processing 
halts and special end of program occurs unless the 
"Corrective Action" comment states that processing 
will continue or that no corrective action is to be taken. 
After the correction is made, the job must be rerun. 
Full instructions appear in the publication, Operator's 
Guide. 

SGI and SG2 Diagnostic Messages for a Tape-Oriented 
System 

11501 XXXXXXXXXX NOT ON TAPE 

Explanation: Request has been made for the named 
item but it cannot be located on the SOF or on the 
Relocatable or Create Library. 

Corrective Action: Check control deck for proper call 
and/or spelling, etc. 

11502 SEQERR-XXXXX 

Explanation: A macro statement sequence number with 
low-order blank or an out-of-order sequence number has 
been encountered in the SIU. 

Corrective Action: Generation continues but the state- 
ment in question is omitted from the library and is 
printed on the SPR. Check the control deck. 

11503 DIRECTORY X NOT AVAILABLE 
Explanation: X can be "1" or "3." 

Corrective Action: Check the control deck to make sure 
directory has been generated previous to this reference. 
If X is not 1 or 3, the PHASE card for the directory has 
been mispunched. 

11504 XXXXXXXXXX LIBRARY NOT AVAILABLE 
Explanation: Request has been made for the named 
library but that library cannot be located or does not 
exist. 

Corrective Action: Check the control deck to make sure 
that a library of the name XXXXXXXXXX has been 
copied, updated, or added by SGI. 

11505 NEW SOF ON XXX 

Explanation: XXX is the x-control field for the unit 
on which the System Generation output file is located.. 
Corrective Action: None. 

11507 LIB TYP UNKNOWN 

Explanation: Request has been made for a library 
whose type is not M, R, or C. 

Corrective Action: Check control deck. The PHASE 
card for the library header may have been punched 



incorrectly. The M, R, or C must be in column 62 of 
the PHASE card. 

11508 BACKSPACE FAILURE - SOF 
Corrective Action: Restart. 

11509 BACKSPACE FAILURE - MJB 
Corrective Action: Restart. 

11510 NEW LIBRARY ON XXX 

Explanation: XXX is the x-control field for the unit on 
which the new library is located. 
Corrective Action: None. 

11511 UNKNOWN HDR TYP 

Explanation: Header record is not proper format. 
Corrective Action: Check control deck. Check that all 
the libraries processed by SGI were done in one block 
and were processed before absolute programs. Also 
check that no conflict exists in input/output assignments. 

11512 NO TYPC COUNTS 

Explanation: Specific cause has not been determined. 
Corrective Action: Check control deck for extraneous 
PHASE cards, order of cards, etc. 

11513 EXTRANEOUS HEADER 

Explanation: Record descriptions contained on MW1 
(header records) do not agree with contents of Job file. 
Corrective Action: Ensure that all requests for SGI to 
INSER, DELET, REPLC, and ADD library material 
were made prior to requests to process absolute format 
records. Also check that no conflict exists in input/out- 
put assignments. 

11514 CHECK CONTROL DECK 

Explanation: A System Generation control card is placed 
where none is expected, or a control card is not where it 
should be (example: LOCATM followed by DELETR), 
Corrective Action: Correct control card deck. 

11515 MODULE XXXXXXXXXX NOT ON GO TAPE 
Explanation: Occurs during library maintenance. The 
named subprogram was not immediately available on 
the SIU and was not found on the Go file. 

Corrective Action: Check control deck. Subprogram 
name may be mispunched. 

11516 SOF RECORD TOO LARGE TO COPY 
Explanation: SGI, when working with largest possible 
records, cannot copy an SOF on a smaller machine than 
was used to generate the SOF. 

Corrective Action: The records on the SOF cannot be 
copied on the size machine being used, with SGI based 
where it is. Regeneration of the SOF is necessary. 

11517 NO ALTERNATE LIBRARY HEADER 
Explanation: SGI has been directed to find an external 
library, but did not find an identifying header record 
on LIB. 

Corrective Action: Tape is probably wrong reel. Mount 
proper reel and begin again. 

11518 (No message) 

Explanation: A macro routine or a model statement has 
been specified, but does not appear on the system file. 
The questionable reference is printed on the SPR. 
Corrective Action: Check control deck. The input to 
SGI may be out of sequence. 
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11519 MACRO DIR EXCEEDS 240 

Explanation: The Macro Library can have only 240 
entries, and this number has been exceeded. 
Corrective Action: Reduce number of macro routines to 
specified limit. 

11520 NO SYSGEN END CARD 

Corrective Action: Check control deck. System Genera- 
tion will process the last card read as if it were followed 
by an END card. No action is required if all other cards 
are in order. 

11521 HDR CD INVALID 

Explanation: Column 60 of the EXEQ card indicates 
a header is desired on the output tape. The card follow- 
ing on the SIU is not a valid header card. 
Corrective Action: Correct deck. 

11522 CC60 OF EXEQ INVALID 

Explanation: Column 60 of the EXEQ card has a digit 
other than "1" or "2." 

Corrective Action: Correct the EXEQ card for the type 
of header desired. 

11523 SOF EXCEEDS 154 LIMIT 

Explanation: Tape SOF may have no more than 154 
items, and this number has been exceeded. 
Corrective Action: Deck may be in error. Some items 
may have been copied several times. 



Disk-Oriented System 

Diagnostic messages that may be produced on the 
console printer during execution of sgi and SG2 are 
listed in sequence by message number in the follow- 
ing section. When one of these messages appears, 
processing halts and special end of program occurs 
unless the "Corrective Action" comment states that 
processing will continue or that no corrective action 
is to be taken. After the correction is made, the job 
must be rerun. Full instructions appear in the Oper- 
ator's Guide. 

SGI and SG2 Diagnostic Messages for a Disk-Oriented 
System 

11521 HDR CD INVALID 

Explanation: Column 60 of the EXEQ card indicates a 
header is desired on the output tape. The card fol- 
lowing on the SIU is not a valid header card. 
Corrective Action: Correct deck. 

11522 CC60 OF EXEQ INVALID 

Explanation: Column 60 of the EXEQ card has a digit 
other than "1" or "2". 

Corrective Action: Correct the EXEQ card for the type 
of header desired. 

11562 CREATLIB NOT ON SOF 

Explanation: SGI has been executed, but the Create 
Library is not on the system. 

Corrective Action: An SOF that includes the Create 
Library must be generated and this SOF used to proc- 
ess the job that caused the message. 



11563 PACKAGE XXXXXXXXXX NOT IN CREATLIB 
Explanation: No packet of the name XXXXXXXXXX 
has been found in the Create Library by SGI. 
Corrective Action: Check the control deck to be sure 
that spelling on CREAT card is correct. 

11564 OUTPUT ON XXX 

Explanation: XXX is the x-control field for the unit on 
which the new output file is located. 
Corrective Action: None. 

11565 DISK LOADER NOT PRESENT 

Explanation: IBSGDL has not been included or gener- 
ated as the first item. 
Corrective Action: Rerun the job including IBSGDL. 

11566 NO SYSGEN END CARD 

Corrective Action: Check control deck. System Genera- 
tion will process the last card read as if it were fol- 
lowed by an END card. No corrective action is neces- 
sary if all other cards are in order. 

11567 CHECK CONTROL DECK 

Explanation: A System Generation control card is placed 
where none is expected, or a control card is not where it 
should be (example: LOCATM followed by DELETR). 
Corrective Action: Correct control card deck. 

1 1 568 ( No message ) 

Explanation: A macro routine or a model statement has 
been specified but does not appear on the system file. 
The questionable reference is printed on the SPR. 
Corrective Action: Check control deck. The input to 
SG2 may be out of sequence. 

11569 SEQERR-XXXXX 

Explanation: A macro statement sequence number with 
low-order blank or an out-of-order sequence number 
has been encountered in the SIU. 

Corrective Action: Generation continues but the state- 
ment in question is omitted from the library and is 
printed on the SPR. Check the control deck. 

11570 ALTERNATE LIBRARY HEADER 

Explanation: SG2 has been directed to find a library 
but did not find an identifying header record on LIB. 
Corrective Action: Tape is probably wrong reel. Mount 
proper reel and begin again. 

11571 MODULE XXXXXXXXXX NOT ON GO FILE 
Explanation: Occurs during library maintenance. The 
named subprogram was not immediately available on 
the SIU and was not found on the Go file. 

Corrective Action: Check control deck. Subprogram 
name may be mispunched. 

11572 XXXXXXXXXX NOT AVAIL 

Explanation: An INCLD card has specified the name 
of an item which is not in the system. 
Corrective Action: Check control deck for proper spell- 
ing of item name. 

11573 XXXXXXXXXX NOT VALID 

Explanation: An INCLD card has specified the name 
of an item which does not contain valid program infor- 
mation. The area assigned to SOF (on the disk) has 
been accidentally altered or destroyed. 
Corrective Action: Reload the SOF from the output tape 
from the previous System Generation run. 
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System Maintenance 



Additions and improvements to the Operating System 
require updating of the Relocatable, Create, and 
Macro libraries. The SG5 program provides a simpli- 
fied method of updating these libraries with a mini- 
mum of card handling. 
Input to the sgs program is: 

1. A modification tape (supplied by ibm) 

2. The user's sof, sgf, or Master file 

3. The required System Monitor control cards ( job, 

ASGN, EXEQ, etc. ) 

Execution of SG5 produces an output containing: 

1. Change data 

2. Control cards to effect these changes 

3. Control cards required to perform functions asso- 
ciated with generation of an sof (exeq, inser, 

ASGN, INCLD, etc. ) 

The control data generated by SG5 becomes siu in- 
put. This input directs execution of the operations re- 
quired to make a normal System Generation update 
run. The final output is an sof, sgf, or Master File 
identical to the original except that the Relocatable, 
Create, and Macro libraries have been updated and 
represent the latest version of the Operating System 
libraries. 

The output of sgs provides the control cards that 
the user normally would code, key punch, and verify 
prior to performing maintenance on his system files. 

A second program, SG4, is also available, ibm uses 
this program to create the modification tape the user 
receives. Some users will not require this program, 
but those with system libraries other than the ones 
supplied by ibm will find that SG4 facilitates mainte- 
nance of these libraries. To generate his own modifica- 
tion tape, the user employs SG4 with the system file, 
the required control cards, and the change modules 
(see "The SG4 Program" in this section). Figure 23 
is a summary of the use of the SG4 and SG5 programs 
and the modification tape. 

If the operating section of the modified system file 
is affected by the library changes and the user wishes 
to incorporate them, another System Generation run 
must be made. The update run with the siu prepared 
by sgs can update only the Macro, Create, and Re- 
locatable Libraries. 

Modification Tape 

The modification tape contains the following data: 
1. Two directory records of 2,500 characters each 







SG5 



Changes 
and Control 
Cards 
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Generation 
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Updated 
System File 



Figure 23. System Maintenance 

2. Card-image data records blocked into 2,000-char- 
acter physical records. These data records con- 
tain library changes preceded by their respective 
control cards 

3. End of File (tape mark) 

4. Standard 120-character trailer label 

5. End of File ( tape mark ) 
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The Relocatable Library modules are blocked so 
that each module begins with a new record, but the 
module can be more than one record long. Padding 
with 9's is used if the module does not complete a 
record. The Macro and Create Library changes are 
continuously blocked (i.e., a new record is not begun 
for each new Macro or Create packet), and padding 
is added to the last record only, if required. 

Both the directory of changes on the tape and a list 
of the control cards generated are printed automatic- 
ally at the end of the SG4 run. ibm includes these 
listings when it supplies the modification tape. 

The directory of changes is useful for checking that 
all desired modifications are included. It is printed 
with five entries per line, each line having the follow- 
ing format: 

ProgrnamelbWbxxxxbbbbbProgrname2bWxxxx . . . etc. 
Ten characters are allowed for the program name. 
W can be R, M, or C according to the type of library 
being changed; b indicates a blank; and xxxx is the 
four-character record count (see Figure 24). 

The control cards are listed one card per line as 
follows: 

xxxbbbProgrnamelbyyyyyW 
The three-character sequence number (xxx), which is 
required by sgs, is followed by three blanks; ten char- 
acters are allowed for the program name; yyyyy is 
the type of card, either beplc, inser, or delet; and 
W is R, M, or C according to the type of library being 
changed (see Figure 25). 



The SG4 Program 

Usually, the user updates his History file just prior to 
using SG4. The SG3 program (see Appendix A in this 
publication) performs the update and, at the same 
time, places Autocoder source statements on MW6. 
These source statements are then processed by the 
Autocoder processor in the normal manner. SG4 gen- 
erates the modification tape using control card in- 
formation and Autocoder output. SG4 can process a 
maximum of 199 program modules in one run. A flow- 
chart showing one use of SG4 is shown in Figure 26. 

Machine Requirements 

SG4 requires two tape units in addition to the sof. 
mwi must be assigned as a work file for the SG4 run. 
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Figure 25. Control Card List 




Figure 26. SG4 Update Data Flow 

and MW2 must be assigned to the modification tape 
that SG4 is generating, mwi and mw2 must be tape 
units; the sof can be a tape or disk unit. If the modi- 
fications have been put on the Go file, mgo must also 
be assigned. 
The tape files are in Move mode and odd parity. 
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Figure 24. SG4 Directory 
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SG4 can handle files with a maximum of 550 records of 
2,000 characters each, or 14,000 records of 80 char- 
acters each. 



Input Format 

The input tape for SG4 can contain three types of ele- 
ments: Macro patches, Create packets, and Relocat- 
able Library modules. These elements must appear in 
the order given below. Each element that is an in- 
sertion or replacement must be preceded by its sgi/ 
sg2 control card(s). 

1. Macro patches, each patch preceded by a replcm 
or inserm control card. 

2. Create packets, each packet preceded by an 
inserc or replcc card and a gener card. 

3. Relocatable Library modules, each module pre- 
ceded by an inserr or replcr card. 

delet cards can be used to remove any library ele- 
ment. The delet card must not have library cards 
immediately following. 

Within each type of element (Macro, Create, or 
Relocatable), the changes for the modules should be 
in the same order as the modules on the system file 
to be updated by SG5. If the programmer follows this 
practice, he can shorten the SG5 run by reducing the 
search time. If the order of the elements is not known, 
the only disadvantage is a longer execution of SG5. 

If SG4 reads an inserr or replcr control card and 
no Relocatable Library module follows it, SG4 searches 
the Go file for the name as it appears in columns 6 to 
15 of the control card. SG4 finds and reads the module 
from the Go file and processes the module normally; 
if SG4 does not find the module, an error message is 
printed. 

Figure 27 is an example of a typical SG4 deck. 



Messages 

The following messages indicate that the output of 
SG4 is invalid. The number of the message is printed 
on the console typewriter; the text, on the spr. A con- 
dition producing any of these messages terminates 
the program. 

11544 UNCORRECTABLE ERROR ON SIU 
Explanation: The input tape has a read error that cannot 
be corrected. 

Corrective Action: Rerun the job with a new input tape. 

11545 UNCORRECTABLE ERROR ON MW1, MW2, or MGO 
Explanation: The indicated tape file has a read or write 
error that cannot be corrected. 

Corrective Action: If the error is on MW1, or MW2, 
rerun the job with a new tape. If the error is on MGO, 
rerun with a backup MGO file. 



6 16 21 

HON** DATE 12345 

HON** JOB SG4 

HON** ASGN MG0,A6 

HON** ASGN HW1.B1 

HON** ASGN HW2.A2 

HON** ASGN HN3,B3 

HON** ASGN MW4.A4 

HON** ASGN HHS.A5 

HON** ASGN MW6.B6 

HON** HOOE GO 

HON** EXEO SG3 

••• CONTROL CARDS TO CALL SYHBOLIC DECKS FRO* HISTORY FILE ••• 

HON** EXEO AUTOCODER,, HW&.NOPCH 

HON** EXEQ SG4 

GET INSERH.AAAAA 

••• CHANGES ••• 

GET REPLCH.AAAAA.BBBBB 

..# CHANGES ••* 

GET DELETN.AAAAA.BBBBB 

GEN08 INSERH.AAAAA 

••• CHANGES ••• 

GEN10 DELETM.AAAAA.BBBBB 

TSYSTEH REPLCC 

GENERTSYSTEH 
»»• SYSTEH CREAT PACKET •«• 
DSYSTEH DELETC 
TDLINKLOADINSERC 

GENERTDLINKLOAO 
••• TDLINKLOAD CREAT PACKET »•• 
SNAPSHOT REPLCR RELOCATABLE 

IBAU10IOTBREPLCR PROGRAMS ARE 

FILESAVE INSERR, FILEREST TAKEN FROM 
IBUPPER DELETR GO FILE 

HON** END 



Figure 27. Typical SG4 Control Card Deck 



The following diagnostic messages indicate errors 
in the input to the program. When any of these errors 
occur, SG4 continues to edit the input for further errors 
but stops processing the input. The messages appear 
with the number on the typewriter console and the 
text on the spr. 

11546 FILE CAPACITY EXCEEDED 

Explanation: The output file produced is larger than the 

maximum allowed. 

Corrective Action: Shorten the input file and rerun the 

job. 

11547 DIRECTORY CAPACITY EXCEEDED 
Explanation: The capacity of SG4, which is 199 program 
modules, has been exceeded. 

Corrective Action: Reduce the number of program mo- 
dules and rerun the job. 

11548 MW1 or MW2 NOT ASSIGNED TO TAPE 
Explanation: The MW1 or MW2 has not been assigned 
as a tape file, as required by SG4. 

Corrective Action: Reassign MW1 or MW2, as required, 
and rerun the job. 

11549 n BAD INPUT CARD •••• (contents of card) 
Explanation: n indicates the type of error, as follows: 

Format 

1 Sequence 

2 Title card 

3 Duplicate entry 

4 GENER card error 

5 Control card missing 

6 Module missing on Go file, or no Go 
file 

Corrective Action: Correct the card in error or supply the 
proper card. 
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The SG5 Program 

The SG5 program prepares the tape siu that is used for 
incorporating the changes to the Macro, Create, and 
Relocatable libraries into the sof, sgf, or Master File. 
This siu includes the control cards required for the 
System Generation update run as well as the changes 
to be made to the system files. 

Two options are available with the program, the 
omit option and the edit option. The omit option per- 
mits the user to incorporate changes to only as many 
modules as he chooses. However, he must be careful 
in choosing to omit any modification. All IBM modifi- 
cation level changes are made on the assumption that 
all previous modification levels have been incorpo- 
rated into the user's system files. If the user omits any 
modification level change, he must make certain that 
later changes to his system files do not make his pro- 
grams inoperable. 

Note: sgs automatically omits any attempt to make 
a change to a program not in the user's Macro, Cre- 
ate, or Relocatable Libraries; therefore, the user does 
not need to specify omission of a change to a module 
not on the system files. 

The edit option gives the user a method of chang- 
ing a Relocatable Library module on an sof tape li- 
brary other than ibmlibr or to respecify the insertion 
point of a Relocatable Library module on the sof. 

In all cases, the input information supplied by the 
user is checked by the program to ensure a satisfac- 
tory run. 

At the end of the sgs run, the program prints a list 
of the element names that were put on the siu for up- 
dating (see Figure 28). The elements are not neces- 
sarily listed in the order in which they were processed. 
The user can compare this list with the directory list- 
ing of the modification tape to check that the proper 
modifications were made. 

Machine Requirements 

The machine configuration required by sgs depends 
upon the physical units on the user's system. A tape- 
oriented system requires at least three tape units. If 
the edit option is used, an additional tape unit is re- 
quired. A disk-oriented system requires at least two 
tape units. If the edit option is used, an additional 
tape unit is required. 

Note: The program can be run with a minimum 



disk system having only one tape unit available to the 
Operating System, but additional time is required for 
the SG5 run, and the tape reel must be changed during 
the run. 

The modification tape for the sgs run (supplied by 
ibm or prepared by the user with an SG4 run) must 
be mounted on the physical unit assigned to MW3. 
From the modification tape and the controlling sof, 
sgf, or Master File, SG5 prepares a new tape siu on 
mwi. The new siu is the input tape for updating the 
user's system file. This siu can be used only to update 
a system file that was used on the sgs run or one that 
is exactly the same; therefore, a separate siu should 
be prepared for updating each system file configura- 
tion. 

sgs opens the necessary system files as tape or disk, 
according to the physical equipment of the user's sys- 
tem. Figure 29 is a summary of the machine configu- 
ration and assignment requirements for sgs. 

Control Cards 

Several control cards define the operation of the sgs 
program. Two types of control cards are required: a 
Monitor exeq control card and Pseudo Monitor con- 
trol cards. Optional cards are also available to accom- 
modate particular requirements of users. 

The Monitor control card and the Pseudo Monitor 
control cards define the system to the program. They 
specify an sgs execution and describe the job and the 
assignment of the physical units for the update run. 

The optional cards are for those systems in which 
the configurations of the system files differ from those 
of the usual Operating System files. The control card 
for the omit option permits the user to omit updating 
of any of the program modules in the relocatable 
libraries. The cards used with the edit option permit 
the user to incorporate a change for a relocatable pro- 
gram on a system library other than that named 
D3MLD3R. In the case where the library has been re- 
arranged, the change cards can be used to respecify 
the insertion point of a new module. 

Insertions of new modules are made as specified by 
the sgi or sg2 control cards. In the case of the Relo- 
catable Library on a tape system, all insert statements 
with only one name are inserted at the end of ebmlibr 
unless an edit pass has been performed to direct the 
insertion to another library. 



GET 


n 


0014 


6EN08 H 


0011 


tOKDF M 


0231 


IBINDX1 R 0001 


IBIN0X2 R 0001 


IBINDX3 


R 


0001 


IBEXPFI R 


0001 


IBEXPFF R 


0001 


EXP R 0001 


IBCBLP2MF1 R 0S20 


IBFTN20 


R 


0328 


IB1301DUMP R 


0150 


1BFILESAVE R 


0176 


IBFILEREST R 0158 





Figure 28. Listing of Update Elements 
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user's physical system 


FILE 


SYMBOLIC UNIT 


PHYSICAL UNIT TYPE 


Normal Tape System 


Modification Tape 


MW3 


Tape 




User's System File 


SOF 


Tape 




SIU Output File 


MW1 


Tape 


(With EDIT option) 


(Program Work File) 


(MW4) 


(Tape) 


Normal Disk System 


Modification Tape 


MW3 


Tape 




User's System Files 


SOF 


Disk 






LIB 


Disk 




SIU Output File 


MW1 


Tape 


(With EDIT option) 


( Program Work File ) 


(MW4) 


( Tape ) 


Minimum Disk System— with DMIN Parameter 


Modification Tape 


MW3 


Tape 




Interim SIU 


MW2 


Disk 




User's System Files 


SOF 


Disk 






LIB 


Disk 




SIU Output File 


MW1 


Tape— same unit as assigned to MW3 


(With EDIT option) 


( Program Work File ) 


(MW4) 


( Tape— same unit as assigned to MW3 
and MW1 ) 



Figure 29. SG5 File Assignments 



Monitor Control Cards 

The following Monitor exeq control cards cause the 
execution of SG5. If the parameters specifying both 
the edit option and the minimum disk system are 
used, they can be in either order, but they must be 
the fourth and fifth parameters of the Monitor Exe- 
cute card: 

MON$$ EXEQ SG5 

This card directs SG5 to build a tape SIU to update the 
user's tape or disk system file. SG5 reads the modification 
tape on MW3, and writes the new tape SIU on MWL 

MON$$ EXEQ SG5,,,DMIN 

This card directs SG5 to build the tape SIU for updating a 
file on a minimum disk system and the user's Relocatable 
Library at LIB. The DMIN parameter indicates that the 
user's system has only one tape unit. SG5 reads the modi- 
fication tape on MW3 and writes the SIU information on 
disk unit MW2. The program then enters a wait loop to 
permit a different tape reel to be mounted on the tape 
unit. (This unit must be assigned to MW1 as well as to 
MW3. ) A message typed on the console typewriter indi- 
cates that the wait loop has been entered. When the tape 
reel is ready, the operator must enter a $50 message to 
break the wait loop and resume processing. SG5 then 
writes the tape SIU information on the tape unit. 

MON$$ EXEQ SG5, , , EDIT 

This card permits the user to modify a Relocatable Library 
module on a system library other than IBMLIBR or to 
change any control card for the Relocatable Library. This 
Monitor control card tells SG5 that a special EDIT pass 
will change Relocatable Library control cards in the SG5 
program supplied by IBM. The control cards that can be 
changed at the time of this EDIT pass are INSERR, 
DELETR, and REPLCR. Every modification released by 
IBM is built to accommodate the Relocatable Library as it 
appeared on the last IBM Master file released. When the 
customer receives the modification tape, he should check 
the enclosed list of Relocatable Library control cards. Every 
Class IV, Format 3 INSER card; Class IV, Format 2 DE- 
LET card; and Class IV, Format 2 REPLC card should be 
noted with care because the module identified by the 
second name on each of these statements must be located 
exactly where specified by the card. If any modules have 
been relocated, an EDIT pass must be performed to replace 
the control card supplied by IBM with cards describing the 



altered locations of the modules (see "Edit Control Cards" 
in this section ) . All Class IV, Format 2 insertions are made 
at the end of the Relocatable Library IBMLIBR unless the 
EDIT pass is made to direct the program to insert the 
module into another library. 

Pseudo Monitor Control Cards 

The Monitor exeq control card must be followed by 
Pseudo Monitor control cards. These control cards 
describe to SG5 the physical environment of the sys- 
tem for the update run. Note that, while the cards 
resemble Monitor control cards, the Pseudo Monitor 
must not contain mon$$ in columns 6 to 10. In the 
following card formats, xx represents tape physical 
units to be assigned by SG5, and yy represents disk 
physical units to be assigned by SG5. 

16 21 

ASGN MDM,xx ( Optional, used for tape or 

disk system) 

(Used for a tape system only) 
( Used for tape or disk system ) 
( Used for a tape system only ) 
( Used for tape or disk system ) 
( Used for a disk system only ) 



Edit Control Cards 

If the user must change the Relocatable Library con- 
trol cards, he must specify an edit pass by using the 
edit parameter in the mon$s exeq control card. He 
must also supply a card in the following format for 
each library control card being changed. 

16 16 21 

xxx namel yyyyy R, name2 

In the above control card format, xxx is the sequence 
number as it appears on the modification tape direc- 
tory listing; namel is the name of the module affected 
by the change in the control card; yyyyy is the type 



JOB 


Anyname 


ASGN 


MWl,xx 


ASGN 


MW2,xx 


ASGN 


MR0,xx 


ASGN 


MJB,xx or yy 


ASGN 


LIB,yy 


ASGN 


SPR 


EXEQ 


SGI 


EXEQ 


SG2 



System Maintenance 77 



of card, either inser, delet, or beplc; and name2 is 
the second name on the system generation control 
card. 

If a Class IV, Format 2 inser card change is to be 
made to a library other than dbmltbr, the edit card 
for that library must be preceded by the following 
card. 



16 
TLIB 



21 
libname 



The name of the library in which the insertion is to be 
made is libname. No more than 50 tlib cards can be 
included in any one deck. 

Figure 30 is a summary of the edit control cards. 
If the edit parameter is used on the Monitor control 
card, at least one of the following cards (or set of 
cards) must appear in its proper place in the deck. 



Col Col 
1 6 


Col 
16 


Col 
21 


Comments 


xxx namea 


INSER 


R,newnamel 




xxx nameb 


REPLC 


R,newname2 




xxx namec 


DELET 


R,neu>name3 




xxx namen 


TLIB 
INSER 


libname 
R 


This set of cards directs 
namen to libname rather 
than to IBMLIB 



NOTE: Sequence numbers (xxx) must be in ascending se- 
quence. They are obtained from the listing supplied with the 
modification tape. 



Figure 30. Summary of edit Control Cards 



OMIT Control Cards 

The omit card specifies to SG5 which of the program 

modules residing on the user's system file are not to 

be updated. The omit card has the following format: 

16 21 

OMIT ProgramA, ProgramB, ProgramC, . . . etc. 

The operands starting in column 21 list the names of 
the Macro patches, Create packets, or Relocatable 
Library modules to be omitted in the updating. 

Any replacement element included on the modifica- 
tion tape, but not on the user's sof, is automatically 
omitted by SG5. 

Note: If the user omits the updating of any ibm 
library modules on his system files, later changes to 
these libraries may make his programs inoperable 
unless a careful check is made at each succeeding 
modification level. 

Control Card Sequence 

The SG5 control cards must appear in the following 
sequence: 



Monitor job card 
Monitor asgn cards 

One Monitor exeq control card with all the neces- 
sary parameters 
edit control cards (if any) 
Pseudo Monitor cards describing the job and the 

physical system 
omit cards (if any) 
The Pseudo Monitor control cards that follow the 
Monitor Cards (and edit cards, if used) must be one 
of the following sets. The symbolic unit assignment 
must be as shown here; however, the physical unit 
assignment depends upon the user's system. 
Tape System 



I 



16 


21 




ASGN 


MDM,xx 


( Tape unit, 


JOB 


SG5 UPDATE 




ASGN 


MW1.A2 


(Tape unit) 


ASGN 


MW2,B2 


(Tape unit) 


ASGN 


MR0.A3 


(Tape unit) 


ASGN 


MJB,B3 


(Tape unit) 


EXEQ 


SGI 




EXEQ 


SG2 




ASGN 


SPR 




Disk System 






16 


21 




ASGN 


MDM,xx 


(Tape unit, 


JOB 


SG5 UPDATE 




ASGN 


MW2,B2 


(Tape unit) 


ASGN 


MJB,D3 


(Disk unit) 


ASGN 


LIB.D2 


(Disk unit) 


EXEQ 


SG2 




ASGN 


SPR 





Examples of Control Card Decks 

Figures 31, 32, 33, and 34, respectively, are examples 
of control card decks for a tape system, a tape system 
with edit modifications, a normal disk system, and a 
minimum disk system with edit modifications. The 
mon$$ job and mon$$ asgn cards preceding the 
mon$$ exeq card are the normal control cards for 
the execution of any program (in this case, sgs). 
The Pseudo Monitor job and asgn cards prepare as- 
signments for the subsequent use of the siu tape. 
The sequence numbers are obtained from the modi- 
fication tape control card listing. No other sequence 
numbers should be used. 

Messages 

Both console and diagnostic messages are used in sgs. 
All diagnostic messages appear on the spr; the mes- 
sage number, 11559, is printed on both the console 
typewriter and the spr. Diagnostic messages indicate 
that there are one or more errors in the information 
supplied to the program by the user. The message on 
the spr may indicate the corrective action to be taken. 
The following diagnostic messages are used: 
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16 21 



MON$$ 


JOB SGS NORMAL 


TAPE 


SYSTEM 


MON** 


ASGN MW1.A2 






OUTPUT TAPE 


MON** 


ASGN MW3.BS 






MODIFICATION INPUT TAPE 


MON** 


EXEQ SGS 










JOB USER JOB 


NAME 






ASGN MW1,A2 






ASSIGNMENTS FOR 




ASGN MM2.B2 






SUBSEQUENT SYSTEM 




ASGN MJB,A3 






GENERATION UPDATE 




ASGN MRO.B3 






RUN 


HON** 


END 









Figure 31. Example for Tape System 



1 


6 


16 21 








MON** 


JOB SGS TAPE UPDATE 


AND EDIT 






HON** 


ASGN MW1.A2 


OUTPUT TAPE 






MON*$ 


ASGN MW3.B5 


MODIFICATION INPUT 


TAPE 




MON** 


ASGN MH4.A3 


MORK TAPE 






MON** 


EXEQ SGS,, .EDIT 






003 


PROGNAMEA 


REPLCR.PROGNAMEB 


EDIT PHASE CONTROL 


CARD 


017 


PROGNAMEX 


DELETR.PROGNAMEY 


EDIT PHASE CONTROL 


CARD 






TLIB USERLIB 


EDIT PHASE CONTROL 


CARD 


025 


PROGNAMEZ 


INSERR 

JOB USER JOB NAME 

ASGN MW1.A2 

ASGN MW2.B2 

ASGN MJB.B2 

ASGN MR0.B3 


EDIT PHASE CONTROL 

ASSIGNMENTS FOR 
SUBSEQUENT SYSTEM 
GENERATION UPDATE 
RUN 


CARD 






OMIT PR0GNAME1.PR0GNAME2 








OMIT PROGNAMEA 








MON** 


END 







Figure 32. Example for Tape System with EDIT 



MON** 


JOB SGS DISK UPDATE 


MON** 


ASGN MW1.A2 I 


MON** 


ASGN MW3.B5 


MONtS 


ASGN LIB, OS 1 


HON** 


EXEQ SGS 




JOB USER JOB NAME 




ASGN MM2,B2 




ASGN LIB.D2 




ASGN MJB.D3 




OMIT PR0GNAME1.PR0GNAME2 


MON** 


END 



OUTPUT TAPE 

MODIFICATION INPUT TAPE 
DISK LIBRARY FILE 



ASSIGNMENTS FOR 
SUBSEQUENT SYSTEM 
GENERATION UPDATE RUN 



Figure 33. Example for Normal Disk System 



1 


6 


16 21 






NONtt 


JOB SGS DISK UPDATE 






MONtS 


ASGN MH1.A2 


OUTPUT TAPE 




NONt* 


ASGN MW3.A2 


MODIFICATION INPUT TAPE 




MONtS 


ASGN HM4.A2 


WORK TAPE 




MONSt 


ASGN LIB.D1 


SYSTEM LIBRARY FILE 




MONtS 


ASGN MU2.DS 


INTERIM SIU 




MONSt 


EXEQ SG5.,,E0IT,DMIN 




003 


PROGNAMEA 


REPLCR.PROGNAMEB 


EDIT PHASE CONTROL CARD 


017 


PROGNAMEX 


DELETR.PROGNAMEY 


EDIT PHASE CONTROL CARD 


025 


PROGNAMEZ 


INSERR, PROGNAMEZ 
JOB USER JOB NAME 


EDIT PHASE CONTROL CARD 






ASGN MH2.A2 


ASSIGNMENTS FOR 






ASGN LIB.D2 


SUBSEQUENT SYSTEM 






ASGN MJB.D3 


GENERATION UPOATE RUN 






OMIT PR0GNAME1 






MONtt 


END 





Figure 34. Example for Minimum Disk System with EDIT 



11559 UNCORRECTABLE I/O ERROR ON SYSTEM TAPE 
Explanation: A read error occurred on the system tape. 
Corrective Action: Run the job with a backup or with a 
new system tape. 

11559 INCLD TABLE CAPACITY EXCEEDED 

Explanation: The program attempted to make more than 
300 entries in the table of program modules being modi- 
fied (e.g. Autocoder, IBTRANSIT, etc.). 



Corrective Action: Reduce the number of program mod- 
ules on the SOF. 

11559 TLIB DIRECTORY CAPACITY EXCEEDED 

Explanation: The program has attempted to enter more 
than 50 EDIT operations in the TLIB Directory. 
Corrective Action: Reduce the number of entries to the 
directory by reducing the number of TLIB card specifi- 
cations and rerun the job. 

11559 CONTROL CARD DECK IN ERROR - CORRECT 
AND RERUN 

Explanation: There is an error in the card deck. 
Corrective Action: Correct the deck and rerun the pro- 
gram. 

11559 READ ERROR ON SIU 

Explanation: A read error occurred on the SIU. 
Corrective Action: See Operator's Guide for the standard 
procedure for SIU errors. 

11559 ERRONEOUS EOF ON MW4 

Explanation: No EOF should occur on MW4 during an 

EDIT run. 

Corrective Action: Rerun after changing the tape on 

MW4. 

11559 ERRONEOUS EOF ON MW3 

Explanation: An erroneous EOF occurred on the modifi- 
cation tape during an EDIT run while SG5 was search- 
ing for a module. 

Corrective Action: Check the EDIT control cards, cor- 
rect, and rerun the job. 

11559 CONTROL CARD ERROR 

Explanation: A parameter on a control card has been 

entered incorrectly. 

Corrective Action: Correct the card and rerun the job. 

11559 ERRONEOUS EOF ON MW2 

Explanation: During an EDIT pass or Disk SG5 run an 
EOF was sensed on MW2. 

Corrective Action: Assign a larger portion of disk storage 
to MW2. 

11559 TLIB CARD INVALID ON DISK SYSTEM 

Explanation: No TLIB control card can be used for the 

Disk System. 

Corrective Action: Correct the deck and rerun the job. 

11559 UNCORRECTABLE I/O ERROR ON SYS DISK 

Explanation: An uncorrectable I/O error occurred on a 
system file (SOF or LIB). 

Corrective Action: Reload the system on disk and rerun 
the job. 

11559 IMPROPER PARAMETER ON EXEQ CARD 

Explanation: A parameter on an EXEQ card has been 

specified incorrectly. 

Corrective Action: Correct the card and rerun the job. 

11559 IMPROPER USE OF DMIN PARAMETER 

Explanation: The DMIN parameter has been, used in- 
correctly. 
Corrective Action: Correct the card and rerun the job. 

11559 INCOMPLETE ASSIGNMENTS CHECK DECK - 
RERUN 

Explanation: One or more assignments have been 
omitted. 
Corrective Action: Correct the deck and rerun the job. 

11559 OMIT CARD IN ERROR - CORRECT AND RERUN 

Explanation: There is an error in an OMIT card. 
Corrective Action: Correct the card and rerun the job. 
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11559 OMIT MODULE NOT IN DIRECTORY 

Explanation: SG5 did not find a module specified for 
omission. 

Corrective Action: Check the deck against the modifica- 
tion tape listing, correct the card, and rerun the job. 

11559 JOB CARD MISSING - CORRECT AND RERUN 
Explanation: A JOB card has been omitted. 
Corrective Action: Insert the correct JOB card into the 
deck and rerun the job. 

11559 NO MDM IN SYSTEM - CORRECT AND RERUN 
Explanation: An ASGN MDM card has been read; how- 
ever, there are no MDM facilities in the system. 
Corrective Action: Remove the ASGN MDM card and 
rerun the job. 

11559 INVALID ASGN CARD - CORRECT AND RERUN 
Explanation: An invalid ASGN card was included in the 
deck. 
Corrective Action: Correct the card and rerun the job. 

11559 NO ASGN CARDS - CORRECT AND RERUN 

Explanation: The ASGN cards were omitted from the 
control deck. 



Corrective Action: Insert the ASGN cards into the deck 
and rerun the job. 

11559 UNCORRECTABLE ERROR ON INPUT TAPE 
Explanation: The input tape has a read error. 
Corrective Action: Rerun the job with a new modification 
tape. 

In addition to the diagnostic messages, the following 
console typewriter messages may appear: 

11558 REPLACE MW3 WITH SCRATCH TAPE - ENTER 
$50 

Explanation: This message appears when the DMIN pa- 
rameter is used on the Monitor EXEQ control card. It 
indicates that the program is ready for the scratch tape 
to be mounted. 

Corrective Action: Replace the modification tape with a 
scratch tape and enter $50 to discontinue the wait loop. 

11560 UPDATE SIU ON MW1 

Explanation: This message indicates end of job and gives 
the location of the new SIU. 
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Appendix A: Maintaining the History File with 
the SG3 Program 

The History file, supplied by ibm as an optional item, 
contains all of the Autocoder statements (in the form 
of blocked-record symbolic program decks ) that make 
up the programs and modules contained on the Master 
file. The SG3 program is used to maintain the History 
file. 

The SG3 program is executed in a standard job run. 
It cannot be run during System Generation. 

A user can obtain a new History file with SG3 by: 

1. Placing new subprograms (in the form of Auto- 
coder, fortban, or cobol symbolic decks) onto the 
History file. 

2. Updating an old History file by inserting and de- 
leting individual symbolic statements. 

3. Copying or merging information from one or 
more History files. The new History file is produced by 
a combination of copying and updating or by merging 
several old History files. 

Note: A file of compiler input statements also can 
be produced when the new History file is being cre- 
ated. This file serves as input for the appropriate 
(Autocoder, Fortran, or cobol) processor for an as- 
sembly or compilation of the updated file. Only one 
Fortran or cobol source program can be placed on 
the compiler input file; any number (limited only by 
the physical capacity of the file ) of Autocoder source 
programs may be placed on the file. 

Additional features, such as the listing and/or 
punching of the new History file, are discussed under 
"Control Cards." 

Program Input and Output Requirements 

The input/output assignments and input/output for- 
mats associated with the SG3 program are indicated 
below. 

Input Units 

1. Control cards, cards for new subprograms to be 
added to the History file, and cards for updating sub- 
programs already on the History file are placed on the 
sru. 

2. The old History file is assumed to be on work file 
MW4. If the user desires, the old History file may be 
placed on another work file (Mwn), or on a reserve 
file (MRn), specified for his system at System Genera- 
tion time. The optional file is specified on the control 
card for the subprogram being copied or updated. 



Note: Work files MW5 and/or mw6 may be re- 
quired for output as explained below. 

Input Format 

1. Monitor control cards are in the format standard 
for the Operating System. SG3 control cards are in the 
format described under "Control Cards." Cards for 
new subprograms, or updating cards for existing sub- 
programs, are in the input format defined for the ap- 
plicable symbolic language. 

2. The old History file is blocked, 25 card images 
per physical record. 

Output Units 

1. A new History file, if specified, is always pro- 
duced on work file mws. No other work or reserve file 
may be substituted for MW5. 

2. The compiler input file, if specified, is always pro- 
duced on work file mw6. No other work or reserve file 
may be substituted for mw6. 

Output Format 

1. The new History file is blocked, 25 card images 
per physical record. 

2. The compiler input file consists of (unblocked) 
card-image records. 

Machine Configuration Requirements 

SG3 requires: (1) the sof plus a minimum of two addi- 
tional tape units, a card reader, and the Standard Print 
Unit, or (2) the sof plus a minimum of four additional 
tape units. The minimum configuration has the follow- 
ing restrictions: 

1. Two runs are required if both a new History file 
and a compiler input file are desired. The first run up- 
dates the old History file. The second run creates the 
compiler input file. With an additional work file, these 
two functions may be performed in one run. 

2. Merging of History files cannot be performed 
with the minimum configuration. An additional work 
file is required for each file to be merged with the 
old History file. 

Note: The Standard Punch Unit is required if the 
user elects to punch his new History file. 

Control Cards 

Four types of control cards may be directed to the 
sgs program: 
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1. copy, to copy one or more subprograms from an 
old History file onto the new History file. 

2. update, to add new subprograms to, or change 
subprograms already on, an old History file. In either 
case, a new History file is produced. To update a sub- 
program that appears on an old History file, the updat 
card must be followed by groups of cards, each group 
consisting of an Insert/Delete control card followed 
by source cards (if any) that are to be inserted. The 
updat card also contains the specifications for the sev- 
eral SG3 options, e.g., printing the new History file. 

3. Insert/Delete, to insert symbolic cards into, or 
delete symbolic cards from, the subprogram specified 
by the immediately preceding updat card. 

Note: Insertion or deletion of symbolic cards in or 
from a Fortran source program is made on the basis 
of pseudo sequence numbers of the cards in the source 
program. Pseudo sequence numbers are necessary be- 
cause there is no provision in the Fortran language to 
assign a sequence, page-and-line, or similar number to 
a source card. To enable updating a Fortran program, 
the user must first place the program on the History 
file by using the updat card siu option, and request a 
listing of that program by placing an l in column 10 
of the updat card. The listing thus obtained for the 
Fortran program placed on the History file will con- 
tain a pseudo sequence number for each card in the 
Fortran program; these numbers never appear in rec- 
ords on the History (or any other) file; they are 
printed only on the listing. When updating a Fortran 
program, SG3 maintains a count of cards read, thereby 
simulating the pseudo sequence numbers that appear 
on the listing. Because updating a Fortran program 
may alter the pseudo sequence numbers assigned, the 
user should specify that the updated Fortran pro- 
gram be listed so that he can have the new set of 
pseudo sequence numbers available for future up- 
dating. 

4. Comment, to place descriptive information onto 
the spr during execution of SG3. 

The following control card discussions refer to se- 
quence numbers and revision letters. 

Sequence Number: This is a card sequence number 
of five characters from 0001A through 99989 that is 
placed in columns 1 through 5 of the output records 
produced by sgs. When the History file is updated, 
new sequence numbers are assigned unless the user 
elects otherwise (column 9, updat card). 

Revision Letter: This is a single-character code ( A 
through Z) that indicates the level of modification of 
each subprogram on the History file. The code is car- 
ried in the header record produced by sgs for each pro- 
gram on the History file. The code is placed in a com- 



ment card when the user specifies that the program be 
placed on the compiler input file. The code also ap- 
pears in the table of contents produced by sgs when a 
new History file is created. The revision letter may be 
used to ensure that updates are performed sequen- 
tially. The user may specify in columns 4 and 5 of the 
updat card that the revision letter on the old History 
file be compared to the revision letter he provides in 
the updat card, that the revision letter be reset to a, 
etc. The revision letter is usually advanced by one 
letter ( e.g., a to b, b to c, y to z, z to a, etc. ) each time 
a program is updated. However, this alteration of the 
revision letter may be overridden by specifications in 
columns 4 and 5 of the updat card. 

Note: Version 3 and later versions of the Operating 
System contain a revised SG3 program. When using the 
new SG3 program to update for the first time any pro- 
gram placed onto the History file by the old SG3 pro- 
gram, the user must give careful attention to coding 
the sequence numbers on which updating is based. 
The sequence numbers coded for the first update must 
exactly match those contained on the old History file; 
these numbers must include the revision letter ap- 
pended to the four-digit sequence numbers by the old 
SG3 program. During the first update run, the new SG3 
program resequences the cards in the program and 
eliminates the revision letter. The new SG3 program 
allows a five-character sequence number that excludes 
the revision letter. In the new SG3 program, the revi- 
sion letter is carried in the program header record 
instead of being appended to each sequence number. 



Copy Card 

CARD 
COLUMN 



1 

2-5 
6-8 



9 
10 



11 



12 



CONTENTS EXPLANATION 

$ Indicates SG3 control card. 

Blank Not used. 
MWn or Location of the old History file; may be 
MRn any unit specified for the system at Sys- 
tem Generation time. 
Blank If blank, SG3 assumes the old History 
file to be on MW4. 

Blank Not used. 

L The subprograms being copied from 

the old History file are to be printed on 
the Standard Print Unit. 
Blank No printing. 

P The subprograms being copied from the 

old History file are to be punched on 
the Standard Punch Unit. 
Blank No punching. 

H The subprograms are to be copied from 

the old History file (location specified 
in columns 6-8) onto the new History 
file on MW5. 
Blank If there are any entries in columns 6-15, 
the old History file is not copied onto 
a new History file. If columns 6-15 are 
blank, the subprograms on the new 
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COLUMN CONTENTS 



13-15 
16-20 

21-75 



Blank 
COPY 



76-80 



natnel, 
name2 



Blank 



EXPLANATION 

History file on MW5 are automatically 
copied from the old History file on 
MW4. There is no printing or punching. 

Not used. 
Type of card. 

This is the name of the subprogram 
being copied with the options specified 
in columns 6-12. In the case of subpro- 
grams previously added to the History 
file by means of the UPDAT card SIU 
option, name is the entry beginning in 
column 21 of that card. 
This entry (comma required) causes 
subprograms namel through and in- 
cluding name2 to be copied from the 
old History file onto the new. 

Not used. 



CABD 

COLUMN 



Updat Card 




CARD 




COLUMN CONTENTS 


EXPLANATION 


1 $ 


Indicates SG3 control card. 


2,3 Blank 


Not used. 



4,5 $$ If there is a $ in column 4 and in col- 

umn 5, the revision letter for this pro- 
gram is set to A. 
Blank $ If column 4 is blank and column 5 con- 
tains a $, the revision letter is not 
checked, but is advanced by one letter. 
Blank X X is any alphabetic character. If column 

4 contains a blank and column 5 con- 
tains any alphabetic character, that 
alphabetic character is compared to the 
revision letter in the header record for 
this program. If the alphabetic char- 
acter is equal to the revision letter, the 
updating proceeds normally, and the re- 
vision letter is advanced by one letter. 
If the alphabetic character is not equal 
to the revision letter, the job is ter- 
minated, and the revision letter is not 
altered. 

*$ If column 4 contains an * and column 

5 contains a $, the revision letter is 
neither checked nor advanced. 

*X X is any alphabetic character. If column 

4 contains an * and column 5 contains 
any alphabetic character, the alphabetic 
character is compared to the revision 
letter in the header record for this pro- 
gram. If the alphabetic character is 
equal to the revision letter, the updating 
proceeds normally, but the revision 
letter is not advanced. If the alphabetic 
character is not equal to the revision 
letter, the job is terminated, and the re- 
vision letter is not altered. 

6-8 MWn or Location of the old History file; may be 

MRn any work or reserve unit specified for 

the system at System Generation time. 

Blank If blank, SG3 assumes the old History 

file to be on MW4. 
SIU This entry indicates that a new subpro- 

gram is to be added to the History file. 
The cards containing the source state- 
ments follow the UPDAT card in the 
SIU. 



CONTENTS 

N 
Blank 



10 



11 



12 



Blank 



Blank 



H 



Blank 



13 



14 



F 

C 

Blank 

1-7 



Blank 
F 



EXPLANATION 

New sequence numbers are not assigned 
for statements on the new History file. 
New sequence numbers are to be as- 
signed for statements on the new His- 
tory file. 

This subprogram on the new History 
file is to be printed on the Standard 
Print Unit. 
No printing. 

This subprogram on the new History 
file is to be punched on the Standard 
Punch Unit. 
No punching. 

The subprogram named beginning in 
column 21 of this card is to be written 
onto the new History file on symbolic 
unit MW5. 

No History file is to be written if there 
is any entry in columns 6-15. If columns 
6-15 are all blank, the subprogram is to 
be written on both the compiler input 
file and the new History file. 

Write card-image records to form Auto- 
coder input file on MW6 for later as- 
sembly. 

Write card-image records to form FOR- 
TRAN input file for later compilation. 
Write card-image records to form 
COBOL input file for later compilation. 
No compiler input file is produced. 

If column 13 contains an A, the SG3 
program produces an EXEQ AUTO- 
CODER card-image record for each 
UPDAT card processed. This card speci- 
fies the options for the Autocoder as- 
sembly of the subprogram named in col- 
umns 21-30. All options for this card, 
except the NOFLG option, are specified 
by the entry in column 14. The column 
14 options for the ( SG3-produced ) 
EXEQ AUTOCODER card follow and 
are explained in the publication IBM 
1410/7010 Operating System; System 
Monitor, Form C28-0319. 
1-NOPRT 
2-NOPCH 
3-NOPRT,NOPCH 
4-NOMAC 
5-NOPRT,NOMAC 
6-NOPCH,NOMAC 
7-NOPRT,NOMAC,NOPCH 

Note: SG3 produces no EXEQ card 
for the first UPDAT card (and the up- 
dating cards associated with it) proc- 
essed. Options for the assembly of a 
single subprogram, or the first of two 
or more subprograms, are specified on 
the MON$$ EXEQ AUTOCODER card 
provided by the user. This card must 
follow the last UPDAT card, with its 
related updating cards, in the SIU. 
No Autocoder options. 
Indicates to SG3 that a FORTRAN His- 
tory file is being maintained. 
Indicates to SG3 that a COBOL History 
file is being maintained. 
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CARD 
COLUMN CONTENTS EXPLANATION 

15 N If an A is specified in column 13, an 

N in this column indicates the NOFLG 
option when this subprogram named 
beginning in column 21 is later assem- 
bled in accordance with the SG3-pro- 
duced EXEQ card (refer to column 14 
explanation ) . 
Blank No option. 

16-20 UPDAT Type of card. 



CAHD 
COLUMN CONTENTS 



21-75 



name This is the name of the subprogram be- 

ing updated with the options specified 
in columns 4 through 13. The name 
must be left-justified in column 21 and 
must not exceed ten alphameric char- 
acters. The first character of name must 
be an alphabetic character. 
If columns 6-8 contain "SIU," the name 
is placed on the History file to identify 
the subprogram that is being added. 
This name is used for all subsequent 
COPY and UPDAT cards to identify the 
subprogram. 



73-80 



Not 

or Blank 

76-80t 



The contents of these columns are 
placed into the Identification field (col- 
umns 73-80 or 76-80) of the History 
file and/or compiler input file for each 
card in the subprogram. 
Blank The Identification field of the subpro- 
gram is carried unchanged. 
tColumns 73-80 for FORTRAN or COBOL; columns 76-80 for 
Autocoder. 



Insert / Delete Card 

Insert/Delete cards pertain to the subprogram desig- 
nated on the last preceding updat card. An Insert/ 
Delete card directs SG3 to insert the immediately fol- 
lowing symbolic cards into (or delete symbolic cards 
from) the subprogram specified on the updat card. 
The point at which the insertion or deletion is to be 
made is specified on the Insert/Delete card. (A request 
to delete a nonexistent card causes the next symbolic 
card to be deleted. ) 



CARD 
COLUMN CONTENTS 



1 

2-12 



xxxxx 



xxxxx, 

YYYYY 



EXPLANATION 

Indicates SG3 control card. 
The symbolic cards that follow this con- 
trol card are to be inserted into the sub- 
program named on the last preceding 
UPDAT card. Within the subprogram, 
the insertion is to be made immediately 
following the subprogram card identified 
by sequence number XXXXX. This se- 
quence number is a one- to five-digit 
number, written free form, left-justified 
(e.g., 829 or 2932). 

The cards with sequence numbers from 
XXXXX through YYYYY are deleted 
from the subprogram named in the last 
preceding UPDAT card and replaced 
by the symbolic cards (if any) that fol- 
low this control card. The sequence 
number is a one- to five-digit number 



Comment 


s Card 


CAHD 




COLUMN 


CONTENTS 


1 
2-5 

6 
7-80 


$ 

Blank 

» 

comments 



EXPLANATION 

written free form, left-justified. The 
sequence numbers XXXXX and YYYYY 
must be separated by a comma. 
13-80 Blank Not used. 

Example 1: $25 beginning in column 1 means: In- 
sert the symbolic cards following this control card into 
the output file(s) behind the card with sequence num- 
ber 00025. 

Example 2: $4310A,43769 beginningx in column 1 
means: Delete cards with sequence numbers 4310A 
through 43769 and insert the symbolic cards following 
this control card in place of the deleted cards on the 
output file(s). 



EXPLANATION 

Indicates SG3 control card. 
Not used. 

Indicates Comments card. 
The contents of this field are printed 
on the Standard Print Unit when en- 
countered during execution of the 
SG3 program. 



SG3 Execute Record 

The Monitor exeq control card required to execute SG3 
is in the format that is standard for the Operating 
System: 

6 16 21 

MON$$ EXEQ SG3,P2,P3 

where the second and third parameters (P2 and P3) 
are described in the System Monitor publication. If 
this format of the exeq card is used, the user must in- 
clude updat, copy, and Insert/Delete cards to direct 
the SG3 program, and Comments cards to place com- 
ments onto the spr. 

SG3 permits a fourth exeq card parameter, copy. The 
format of an exeq card containing this fourth param- 
eter (and omitting the second and third parameters) 
is: 

6 16 21 

MON$$ EXEQ SG3,„COPY 

The copy parameter on the exeq card may be used 
to cause copying of an entire History file when no up- 
dating is to be performed. If only the copy function is 
desired, no additional control cards are required. The 
History file to be copied is assumed to be on work file 
mw4; the new History file is written on work file mws. 
Because of the absence of additional control cards, no 
sgs options (e.g., writing a compiler input file) are 
available. 

With certain restrictions, the copy parameter may 
also be used on the exeq card which initiates SG3 proc- 
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essing for a run during which updating is to be per- 
formed. The appropriate updat, Insert/Delete, and 
Comments control cards must follow the exeq card. 
No copy control cards are required, because the copy 
parameter in the exeq card causes copying of all sub- 
programs not updated from the old History file to the 



new. 



The following restrictions apply to the use of the 
copy parameter on the exeq card for an SC3 run during 
which updating is to be performed. 

1. Only a single History file may be updated and 
copied; that History file must be on work file MW4. 

2. No updat control card with the siu parameter is 
permissible; i.e., no new subprograms may be added 
to the History file. 

3. copy control cards cannot be used. 

Example 

Figure 35 illustrates the use of SG3 control cards to in- 
clude a new subprogram on the new History file, to 
update a subprogram on the old History file, and to 
copy a subprogram from the old History file to the 
new History file. Monitor and Linkage Loader control 
cards are also shown; they specify assembly (assum- 
ing Autocoder subprograms) of two of the subpro- 
grams handled by SG3, and execution of one of the 
two programs assembled. Following is a brief explana- 
tion of the control cards. 

The first packet of control cards (job through exeq) 
assigns a name to the job, declares mode go, assigns 
required input/output units, and causes execution of 
SG3. The first updat card causes SG3 to: 

1. Read a new subprogram, samplei, from the siu. 

2. Place samplei on the new History file on mws. 

3. Place samplei, an Autocoder subprogram, on the 
compiler input file on MW6. 



4. List samplei on the spb, and punch it on the spu. 
The second updat card causes SG3 to: 

1. Update sample2, a subprogram on the old His- 
tory file on MW4, and place the updated version of 
sample2 on the new History file following samplei. 

2. Place samples, an Autocoder subprogram, on the 
compiler input file following samplei. 

Insert/Delete cards $24 and $35,46 indicate where 
the modifications in samples are to be made. Updat- 
ing symbolic cards are placed in the siu as indicated 
by the comment cards in the example. 

The copy card causes samples to be copied from 
MW4 to mws, the new History file. 

The exeq autocoder card causes samplei and sam- 
ples to be assembled from the compiler input file 
(mw6) and placed on the Go file. 

The exeq linkload card and the following two 
cards cause sample2 to be placed onto the Job file. 

The exeq pbogbama card causes samples to be exe- 
cuted from the Job file. 



Trailer Label for History File 

A standard 120-character trailer label is added to the 

end of each new History file created by SG3. The trailer 

is in the following format: 

Ieoh (positions 1 through 4 of the record) 

nnnnnn (block count in position 67 through 72 of record) 

Heading for Listing Page 

The following header is placed on a listing of a new 
History file produced by SG3: 

where xxxxx is the date in year-day format, and nnn is 

DATE . . . xxxxx ***'*SG3 LIST ••••• PAGE ... nnn 
the page number. 



MONSS JOB HISTFILE 
MONITOR ASSIGNMENT CARDS ••• 



* 

S 
S24 

S35 



MONSS 
MONSS 
MONSS 
MONSS 
MONSS 
MONSS 
MONSS 
MONSS 
MONSS 
SSSIU LPHA 



ASGN MJB.A1 

ASGN MG0.B2 

ASGN MM4.A6 

ASGN MHS.A2 

ASGN MU6.A3 

MODE GO 

rSEJ !~£ U L2i. ST0RY F,L6 CONSISTING OF SAMPLEI PROM SIU 

EXEQ SG3 SAMPUEZ * SAMPLE3 FROU EXISTING HISTORY FILE. 
UPDATSAMPLE1 



.46 



< INSERT SYMBOLIC CARDS FOR HtSTORY FILE.) 
UPOATSAMPLE2 

•S-Kfc&S'SSI P^cId'hIII:? "<»-<-<>«»«= CARD 24 



(DELETE CARDS 35 THROUGH 46. 

S2 M ??bi. C ^S* R 2l T0 BE INSERTED BEFORE CARD 47 
OF SAMPLE2 ARE PLACED HERE.) 
COPY SAMPLE3 

COMT EXECUTE AUTOCODER TO COMPILE SAMPLEI 
EXEQ AUTOCODER.. CW6 

COMT EXECUTE LINKLOAD TO BUILD A JCB FILE 
EXEQ LINKLOAD 
PHASEPROGRAMA 
CALL SAMPLE2 
COMT EXECUTE PROGRAMA 
„■.;.—; _ eXeQ PROGRAMA, MJB 

DATA CARDS - OPTIONAL »»• 

MONSS END OR 

MONSS JOB NEXT JOB 

Figure 35. Control Cards for Sample Job Using sg3 



MONSS 
MONSS 
MONSS 
MONSS 



MONSS 
MONSS 



♦ SAMPLE2 
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SG3 Diagnostic Messages 

SG3 may produce several diagnostic messages, which 
are placed on the console typewriter and/or the spr. 
These messages, grouped according to the unit(s) on 
which they appear, are explained below. 

Console Typewriter and SPR 

The following messages appear on both the console 
typewriter and the spr. Message text alone is typed on 
the console typewriter; both message text and the con- 
tents of the erroneous card are placed on the spr. Ac- 
tions to be taken are indicated at the end of the ex- 
planations of the messages. For details on the "Console 
Inquiry" action, see "On Console Typewriter Only." 

11540 DIAGNOSTIC END 01 

Explanation: Designation of work/reserve file for History 
file residence is invalid. Only Monitor work/reserve files 
incorporated into the system at System Generation time 
are valid. 
Action: Correct card and rerun job. 

11540 DIAGNOSTIC END 02 

Explanation: Revision letter specified in control card does 
not match that in header for subprogram. 
Action: Console Inquiry. 

11540 DIAGNOSTIC END 03 

Explanation: Subprogram requested is not on History file. 
Action: Correct card and rerun job. 

11540 DIAGNOSTIC END 04 

Explanation: No $ in column 1 of control card. 
Action: Correct card and rerun job. 

11540 DIAGNOSTIC END 05 

Explanation: Card should be COPY or UPDAT card. 
Action: Console Inquiry. 

11540 DIAGNOSTIC END 06 

Explanation: Column 13 of UPDAT card contains invalid 
character. Valid characters are: F, C, A, and blank. 
Action: Console Inquiry. 

11540 DIAGNOSTIC END 07 

Explanation: Column 12 of UPDAT card contains invalid 
character. Valid characters are: H and blank. 
Action: Correct card and rerun job. 

11540 DIAGNOSTIC END 08 

Explanation: Column 11 of UPDAT card contains invalid 
character. Valid characters are: P and blank. 
Action: Console Inquiry. 

11540 DIAGNOSTIC END 09 

Explanation: Column 10 of UPDAT card contains invalid 
character. Valid characters are L and blank. 
Action: Console Inquiry. 

11540 DIAGNOSTIC END 11 

Explanation: Control card contains no subprogram name. 
Action: Console Inquiry. 

11540 DIAGNOSTIC END 12 

Explanation: Sequence number in last card read is in 

error. 

Action: Correct card and rerun job. 



On Console Typewriter Only 

One message, directed to the operator and requesting 
a console inquiry for a 11540 diagnostic end nn mes- 



sage, is typed only on the console typewriter. That 
message is: 

11541 ENTER $3P or $3S 

The $3P response will cause the erroneous card to be 
ignored, and the run to proceed normally. 

The $3S response will cause processing to be termi- 
nated, and the remaining control cards to be checked. 
Errors found in checking control cards after process- 
ing is terminated are indicated by diagnostic messages 
and discussed in the following section. 

On SPR Only 

The following messages are put onto the spr only. 
Messages 11542 through 11545 may be produced dur- 
ing the normal processing of SG3. Message 11546 is pro- 
duced only when checking control cards after termina- 
tion of normal SG3 processing. The contents of the er- 
roneous cards follow the 11546 messages. 

MESSAGE EXPLANATION 

SG3 is unable to read the old 
History file; the run is ter- 
minated. 

SG3 is unable to read the 
new History file; the run is 
terminated. 

SG3 is unable to read the 
Standard Input Unit; the run 
is terminated. 

The run has been terminated. 
The last subprogram on new 
History file may be invalid. 



11542 



11542 



11542 



11543 



11544 



11545 



UNCORRECTABLE 
I/O ERROR ON 
OLD HISTORY 
UNCORRECTABLE 
I/O ERROR ON NEW 
HISTORY 

UNCORRECTABLE 
I/O ERROR ON SIU 
INPUT RECORD 
THIS RUN HAS BEEN 
DIAGNOSTICALLY 
TERMINATED. THE 
LAST FILE IS 
POSSIBLY 
ERRONEOUS. 
400 PROGRAM 
CAPACITY OF FILE 
HEADER TABLE HAS 
BEEN EXCEEDED. 
UNEXPECTED END 
OF FILE ON MWx. 



11546 "" ERROR 01 
IN FORMAT 
OF CARD 

11546 •"* ERROR 02 
IN FORMAT 
OF CARD 

11546 * s »* ERROR 03 
IN FORMAT 
OF CARD 

11546 ••** ERROR 04 
IN FORMAT 
OF CARD 

11546 *"* ERROR 05 
IN FORMAT 
OF CARD 



Capacity of History file 
(400 subprograms) ex- 
ceeded; the run is terminated. 

Unexpected end-of-file con- 
dition on MW5 or MW6. 
The capacity of the new His- 
tory file or the compiler in- 
put file is exceeded; the run 
is terminated. 

Sequence field of last card 
read is in error. 

Column 13 of UPDAT card 

contains invalid character. 

Valid characters are: A, F, 

C, and blank. 

Column 12 of UPDAT card 

contains invalid character. 

Valid characters are: H and 

blank. 

Column 11 of UPDAT card 

contains invalid character. 

Valid characters are; P and 

blank. 

Column 10 of UPDAT card 

contains invalid character. 

Valid characters are: L and 

blank. 



MESSAGE 

11546 "*' ERROR 06 
IN FORMAT 
OF CARD 



EXPLANATION 

Designation of work/reserve 
file (in columns 6-8 of UP- 
DAT or COPY card) for 
History file residence is in- 
valid. Only those Monitor 
work/reserve files incorpo- 
rated into the system at Sys- 
tem Generation time are 
valid. 



Appendix B: Operating System Core-Storage 
Requirements 

The values below provide guidelines to estimate the 
core-storage requirements for an Operating System. 
The figures are subject to change as modifications are 
made to the system. (New figures will be published 
should a change of more than ten percent occur. ) 



Resident Monitor Requirements 



Basic Resident Monitor 

Note: These figures include all in- 
dex registers (and floating-point 
areas ) . 
Completely tape-oriented, 1-channel 

IOCS 
Completely 1301/2302 disk-oriented, 1- 
channel IOCS 

Note: The disk-oriented Monitor 
includes the 1301/2302 disk IOCS 
routines. 
Tape-oriented with 1301/2302 disk ca- 
pabilities, 1-channel IOCS 
Additional 1301/2302 disk IOCS chan- 
nels 
Additional 1301 disk IOCS channels 
Optional System Functions 
Standard Print Unit 
Unit-record 

Note: When the Standard Print 
Unit and/or Standard Punch Unit 
are specified as unit-record equip- 
ment, the IOCS unit-record routine 
must be included. If an IBM 1442 
Card Reader is specified at System 
Generation, an additional 24 posi- 
tions of core storage are needed. 
Tape Unit 

Note: The following file assign- 
ment core-storage sizes must be 
added where applicable: 
Each symbolic unit— 5 
Each unit-record device— 9 
Each tape unit (MDM specified) 

-14 
Each tape unit (MDM not speci- 
fied) -9 
Each disk area— 20 
Variable unit 
Standard Punch Unit 
Unit-record 



CORE- 
STORAGE 
LOCATIONS 
REQUIRED 



7,825 

11,660 

9,340 

600 each 
350 each 

280 



260 



320 
240 



Note: When the Standard Print 
Unit and/or Standard Punch Unit 
are specified as unit-record equip- 
ment, the IOCS unit-record routine 
must be included. If an IBM 1442 
Card Reader is specified at System 
Generation, an additional 24 posi- 
tions of core storage are needed. 
Tape unit 

Note: The following file assignment 
core-storage sizes must be added 
where applicable: 

Each symbolic unit— 5 

Each unit-record device— 9 

Each tape unit (MDM specified) 

-14 
Each tape unit (MDM not speci- 
fied)^ 
Each disk area— 20 
Variable unit 
Core-Image file capability 

Note: The following file assignment 
core-storage sizes must be added 
where applicable: 

Each symbolic unit— 5 

Each unit-record device— 9 

Each tape unit (MDM specified) 

-14 
Each tape unit (MDM not speci- 
fied) -9 
Each disk area— 20 
Note: When MDM (Core Image 
file) - is specified, IOCS Checkpoint 
routine must be included. 
Labeled system files (80 or 120 char- 
acters ) 

Note: When labeled system files are 
specified, the corresponding (80- or 
120-character) IOCS label routine 
must be included. 
Alternate Input Unit (AIU) capability 
Snapshot 

Note: Because Snapshot begins at 
an even-hundred core-storage loca- 
tion, up to 99 additional core-storage 
positions may be required. 

Optional IOCS Routines 

Unit-record 

Note: When the Standard Print 
and/or Standard Punch Unit are 
specified as unit-record equipment, 
the IOCS unit-record routine must 
be included. If an IBM 1442 Card 
Reader is specified at System Gen- 
eration, an additional 24 positions 
of core storage are needed. 

80-character tape labels 

Note: When labeled system files are 
specified, the corresponding (80- or 
120-character) IOCS label routines 
must be included. 

120-character tape labels 

Note: When labeled system files 
are specified, the corresponding (80- 
or 120-character) IOCS label rou- 
tine must be included. 

Label exit routine 

Tape error statistics 



CORE- 
STORAGE 
LOCATIONS 
REQUIRED 



260 



270 
50 



40 



150 
2,000 



250 



1,225 



1,445 



350 
575 
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COKE-STORAGE 
LOCATIONS REQUIRED 



Implementation of user-written service 
routines 445 

Checkpoint, IBM 7330 Tape Units not 
specified 410 

Note: When MDM (Core Image 
file) is specified, IOCS Checkpoint 
routine must be included. 
Checkpoint, IBM 7330 Tape Units 
specified 460 

Note: When MDM (Core Image 
file) is specified, IOCS Checkpoint 
routine must be included. 
Shared Disk 
Type A Generation 

First channel 300 

Each additional channel 240 

Type B Generation 

First channel 250 

Each additional channel 190 

Type C Generation 

First channel 90 

Each additional channel 90 

Type D Generation 
First channel 350 

Each additional channel 270 

Optional Resident Monitor Requirements for TP 



Extension of IOCS 

One of the following Supervisors: 

No dump and restore capability 

Tape dump and restore capability 
(TPTAPEDUMP) 

Disk dump and restore capability 
(TPDISKDUMP) 

Tele-processing only 

TPBASSUPER 
"Start" and "end" modules, 1-channel TP 
Additional "start" and "end" modules for 

the second TP channel 
For device indicated: 

Programmed Transmission Control 

IBM 1050 Data Communications 
System 

IBM 1414, Model IV or V with IBM 
1009 Data Transmission Unit 

IBM 1414, Model IV or V with IBM 
1014 Remote Inquiry Unit 

IBM 1414, Model IV or V with 
Telegraph Terminal Unit 

One of the following load programs: 
Absolute tape loader 
Absolute 1301 disk loader 
Relocatable tape loader 
Relocatable 1301 disk loader 

Note: TP Directory requires 20 positions of core storage for 
each memory map entry and 14 positions for each directory 
entry. 

Optional Resident Monitor Requirements for SPOOL 

Type I SPOOL 

Using IBM 1402 Card Read Punch only 950 per 

(CRD) channel 

Using IBM 1402 Card Read Punch and 1,225 per 

IBM 1403 Printer channel 
(ALL) 



1,650 

3,400 
1,303 

1,440 

3,470 

4,400 

58 

58 

2,770 per 

channel 

1,400 per 

adapter 

2,090 per 

adapter 

1,250 per 

adapter 

1,170 per 

adapter 

4,400 
6,110 
6,580 
6,320 



core-storage 
locations required 

Type II SPOOL 1,300 per 

channel 
Type III SPOOL 3,200 for 

channel 
1,250 for second 
channel 
Note: The stated figures do not include the number of posi- 
tions that are required for a user-written editing routine. The 
Type II spool figure should be used for both Type II and 
Type III spool in a tp system. 

Basic Resident Monitor Requirements for 131 1 Disk 

ADDITIONAL 
CORE-STORAGE LOCATIONS 
SEQUENTIAL 

AND NONSEQUENTIAL 

NONSEQUENTIAL ONLY 



(no 6th IOKDF 
operand) 
First channel with 1311, Resident 
Monitor with tape-processing 
facilities only 2,800 

First channel with 1311, Resident 
Monitor with tape and 1301/ 
2302 processing facilities 2,350 

Second channel with 1311 750 



Optional 1311 Label Routines 

100-character disk label routines, if 
120-character tape label routines 
have not been included in Resi- 
dent Monitor 

100-character disk label routines, if 
120-character tape label routines 
have been included in Resident 
Monitor 

1311 label exit routines, if tape 
label exit routines have not been 
included in Resident Monitor 

1311 label exit routines, if tape 
label exit routines have been in- 
cluded in Resident Monitor 

Nonresident Requirements 



( 6th iokdf 
operand) 



1,600 



1,300 
750 



900 



350 



300 



50 



CORE-STORAGE 
LOCATIONS required 



TAPE 
ORIENTED 



DISK 
ORIENTED 



Compilers 

Autocoder 19,000 20,050 

Note: All remaining available core 
storage is used by Autocoder as 
follows: 702 for label table; 30% for 
literal table. 
COBOL 28,500 38,950 

Note: All remaining available core 
storage is used by COBOL for tables. 
FORTRAN 26,550 35,550 

Note: All remaining available core 
storage is used by FORTRAN for 
tables. 
File Organization System 

System Definition 5,000 

File Organization 4,000 to 43,300 

(min. UNLOAD) (max. ADD) 
Extended IOCS Modules 7,000 to 10,150 

Note: Each file table relating to an organized file includes a 
270 position file table prefix in addition to the standard file 
table of 45 to 57 positions. 





CORE-STORAGE 




LOCATIONS REQUI1 


Utility Programs 




Snapshot 


2,000 


Storage Print 


8,000 


Tape Print 


7,000 


Disk Print ( 1301, 2302, 1311 ) 


11,100 


1301 Format/ Address Generator 


14,000 


2302 Format/Address Generator 


13,000 


File Save program 


20,000 


File Restore program 


18,500 


Data File Generator 


19,400 


1311 Format/Address Generator 


8,500 


1311 Disk Label Program 


7,500 


Random-Processing Scheduler 




Basic 


3,300 


DEFSA macro 


180 


MVRSA macro 


250 


PUT macro 


375 


FSEQP macro 


850 


Output only 


180 


Each 1301 disk module 


13 


Additional Tele-processing Programs 




TPATLIBGEN 


17,140 


LINKLOADRT 


20,500 


TPADLIBGEN 


14,840 


LINKLOADRD 


22,800 


TPLDDCP1 


500 


TPLDDCP2 


500 


1311 Scan Feature 


450 


1311 Cylinder overflow routines 


500 


Linkage Loader 




Tape 


25,600 


1301/2302 Disk Storage 


30,200 


System Generation, Tape or 1301/2302 




Disk Storage 


27,000 


Transitional Monitor 




Tape-oriented system 


13,340 


Disk-oriented system 


15,250 


POWTRAN 


1,500 


Core Image file capability 


670 


Restart 




1-charmel IOCS 


3,500 



Note: When Restart is desired, IOCS Checkpoint routine must 
be specified. 

Additional IOCS channels 600 each 

Depending upon inclusion of 
some or all optional system 
functions ( excluding Snap- 
shot) 25 to 625 

Note: The following file assignment core-storage sizes must be 

added where applicable: 

Each symbolic unit— 5 

Each unit-record device— 9 

Each tape unit (MDM specified)— 14 

Each tape unit (MDM not specified)— 9 

Each disk area— 20 



Appendix C: IOCS Timing Estimates 

Timing estimates for the iocs can be made from the 
following information. These timings do not take into 
account exceptional conditions (e.g., busy and not 
ready conditions) on the i/o devices. 



SCHEDULING FUNCTIONS 
(NOTE 1) 

1. Blocking/unblocking of GET or 
PUT, time per record (Note 2) : 



TIMING IN MICROSECONDS 
IBM 1410 IBM 7010 



scheduling functions 
(noteI) 

a. GET or PUT, Form 2 data 
records 

b. GET, Form 4 data records 

c. PUT, Form 4 data records 

2. GET FILE: 

a. One IORW is sent to a read/ 
write list; file consists of un- 
blocked records; not pre- 
ceded by a GET FILE, 
DEFER 

b. GET FILE following a GET 
FILE.DEFER; file consists 
of unblocked records 

c. Additional time for a GET 
FILE if file consists of 
blocked records 

d. Additional time for a GET 
FILE if file is on IBM 1301 
Disk 

3. GET FILE.DEFER 

INPUT/OUTPUT FUNCTIONS 

1. Service an interrupt due to the 
completion of an overlapped op- 
eration; no error conditions; an- 
other IORW is added to a file list 
( Note 3 and Note 4 ) 

2. Start a pending operation and re- 
turn to an interrupted instruction 
(Note 3), where 

u — not overlapped 
o — overlapped 

3. To start SEEK operation, non- 
sequential 

4. Additional time to start SEEK 
operation, full-track sequential 

5. To start input/output operation 
after detecting SEEK complete 
interrupt 



TIMING IN MICROSECONDS 
IBM 1410 IBM 7010 



370 
370 
595 



2,747 



1,274 



486 



683 
2,322 



130 
130 
210 



879 



408 



155 



228 
743 



TIMING IN MICROSECONDS 



IBM 1410 



2,075 



D3M-7010 



648 



851 u 
549 o 



277 u 
173 o 



1.470+50M 560+ 16M 



890 



1,450+50M 
+50n 



300 



6. Additional time to start input/ 
output operation if another mod- 
ule, having a higher priority, has 
a SEEK pending 
In the module table: 
M = Total number of modules on same channel. 



555+16M 
+ 16n 



820+50p 350+ 16p 



Placement of object module in module table as deter- 
mined by the DSKDF macro-instruction (for module 
00, n = 1; for module 01, n = 2; etc.) 
: Placement of module with SEEK pending in module 
table as determined by the DSKDF macro-instruction 
(for module 00, p = 1; for module 01, p = 2; etc.) 



SHARED DISK FILE CONSIDERATIONS 



TIMING IN MICROSECONDS 
IBM 1410 IBM 7010 



1. Additional time for any tape I/O 
operation if shared-file IOCS is 

generated. 270 104 

2. Additional time for any disk I/O 
operation if shared-file IOCS is 

generated. 955 484 

Note 1: The times listed for the scheduling functions are 
generally overlapped with respect to all channels. 

Note 2: If a GET or PUT must move a data record, add 
the time required for the move to the times listed. 

Note 3: These times are not overlapped with respect to the 
channel being serviced except for SEEK operations in process. 

Note 4: Additional time required to service an interrupt 
if SPOOL was specified at System Generation time is 146 micro- 
seconds for IBM 1410 and 48 microseconds for IBM 7010. 
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